Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Na tej stronie znajdziesz podstawowe wymagania dotyczące kodeków wideo klienta interfejsu Google Meet Media API, które zapewniają dobrą jakość obsługi.
Wymagania funkcjonalne
Ta sekcja określa wymagania dotyczące typów i funkcji kodeków.
Funkcja
Wymaganie
Profil
AV1
VP9
VP8
Main
Profile 0
Nie dotyczy
Skalowalność
Dekoder musi obsługiwać skalowalność czasową, przestrzenną lub obie te funkcje, jeśli jest to wymagane przez specyfikację kodowania dla danego typu kodeka i profilu.
Format surowego wideo
Kodek musi być w stanie przetwarzać rozdzielczości nieparzyste (np. gdy szerokość lub wysokość klatki nie są wielokrotnością 2, np. 133 × 141). W przypadku formatów podpróbkowania chrominancji liczba próbek chrominancji w każdym wymiarze musi być zaokrąglana w górę, gdy jest obliczana na podstawie liczby próbek luminancji.
Przycinanie, dodawanie marginesów ani skalowanie nie są dozwolone. Rozdzielczość klatki wyjściowej musi być zgodna z rozdzielczością klatki wejściowej.
Wymagania operacyjne
Ta sekcja określa wymagania dotyczące różnych warunków, w których kodek wideo ma działać. Naruszenie tych wymagań może ograniczyć użycie kodeka do podzbioru scenariuszy, ale niekoniecznie uniemożliwia jego użycie. Jeśli na przykład maksymalna liczba instancji kodeka jest mniejsza niż wymagana, kodek nadal może być używany razem z kodekami innych typów lub implementacji.
Parametr
Wymaganie
Minimalna rozdzielczość (w pikselach)
≤ 128 × 128
Maksymalna rozdzielczość (w pikselach)
≥ 2880 × 1800
Minimalna liczba klatek na sekundę
≤ 1
Maksymalna liczba klatek na sekundę
≥ 30
Minimalna szybkość transmisji bitów (kb/s)
≤ 30
Maksymalna szybkość transmisji bitów (kb/s)
≥ 5000
Maksymalna liczba instancji dekodera
≥ 3
Maksymalna łączna przepustowość dekodowania, piksele na sekundę
≥ 3 × 2880 × 1880 × 30
Wymagania dotyczące wydajności
Ta sekcja określa wymagania dotyczące wydajności kodeka. Naruszenie tych wymagań może znacząco wpłynąć na wygodę użytkowników i niemal na pewno uniemożliwić korzystanie z kodeka.
Parametr
Wymaganie
Maksymalny czas przetwarzania między klatkami (w sekundach)
≤ 1 / max(30, encode_target_frame_rate_fps)
Maksymalny czas przetwarzania klatki kluczowej w sekundach
≤ 2 / max(30, encode_target_frame_rate_fps)
Czas przetwarzania klatki to różnica czasu między 2 zdarzeniami: 1) kodek dostarcza klatkę i 2) kodek odbiera klatkę. Średni czas przetwarzania klatki jest obliczany w okresie co najmniej 10 sekund, w którym znajduje się co najmniej 10 klatek. Maksymalny czas przetwarzania klatki to najwyższa wartość spośród wszystkich czasów przetwarzania poszczególnych klatek.
Przepustowość jest obliczana jako liczba przetworzonych klatek, w tym odrzuconych, podzielona przez różnicę czasu między 2 zdarzeniami: 1) kodek dostarcza ostatnią klatkę i 2) kodek dostarcza pierwszą klatkę.
Przypadki testowe
Oto przykłady testów, które możesz przeprowadzić:
Testy
Przepustowość dekodowania
Dekoduj jednocześnie maksymalnie 3 strumienie o rozdzielczości 2880 × 1880 × 30 i sprawdź, czy dekodery nie naruszają wymagań dotyczących wydajności.
Zgodność dekodera
dekodować zestaw wstępnie zakodowanych strumieni bitów; Dane wyjściowe dekodera testowego muszą być zgodne z danymi wyjściowymi dekodera referencyjnego (libvpx w przypadku VP8 i VP9, libaom w przypadku AV1).
Skalowalność czasowa
Dekodowanie wideo z wieloma warstwami czasowymi (2 i 3). Dane wyjściowe dekodera testowego muszą być zgodne z danymi wyjściowymi dekodera referencyjnego.
Skalowalność przestrzenna
Dekodowanie filmów z wieloma warstwami przestrzennymi (2 i 3). Dane wyjściowe dekodera testowego muszą być zgodne z danymi wyjściowymi dekodera referencyjnego.
[null,null,["Ostatnia aktualizacja: 2025-08-29 UTC."],[],[],null,["# Video codec requirements for Meet Media API\n\n| **Developer Preview:** Available as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), which grants early access to certain features. \n|\n| **To use the Meet Media API to access real-time media from a conference, the Google Cloud project, OAuth principal, and all participants in the conference must be enrolled in the Developer Preview Program.**\n\nThis page provides the basic requirements for Google Meet Media API client video\ncodecs to ensure a good user experience.\n\nFunctional requirements\n-----------------------\n\nThis section specifies the requirements for the codec types and features.\n\n| Feature | Requirement |||\n|------------------|--------|-------------|-----|\n| Profile | AV1 | VP9 | VP8 |\n| Profile | `Main` | `Profile 0` | N/A |\n| Scalability | Decoder must support temporal scalability, spatial scalability, or both if required by the coding specification for given codec type and profile. |||\n| Raw video format | Codec must be capable of processing odd resolutions (such as when frame width or height are not multiple of 2; for example, 133 × 141). For subsampled chroma formats, the number of chroma samples per dimension must be rounded up when derived from the number of luma samples. Cropping, padding, or scaling isn't allowed. Resolution of the output frame must match the resolution of the input frame. |||\n\nOperational requirements\n------------------------\n\nThis section specifies requirements for various conditions the video codec is\nexpected to operate in. Violation of these requirements may restrict the usage\nof the codec to a subset of scenarios but doesn't necessarily prevent it from\nbeing used. For example, if the maximum number of codec instances is less than\nrequired, the codec can still be used together with codecs of other types or\nimplementations.\n\n| Parameter | Requirement |\n|----------------------------------------------------|---------------|---|---|---|\n| Minimum resolution, pixels | ≤ 128 × 128 |\n| Maximum resolution, pixels | ≥ 2880 × 1800 |\n| Minimum frame rate, FPS | ≤ 1 |\n| Maximum frame rate, FPS | ≥ 30 |\n| Minimum bitrate, kbps | ≤ 30 |\n| Maximum bitrate, kbps | ≥ 5000 |\n| Maximum decoder instances | ≥ 3 |\n| Maximum total decode throughput, pixels per second | ≥ 3 × 2880 × 1880 × 30 ||||\n\nPerformance requirements\n------------------------\n\nThis section specifies the requirements on codec performance. Violation of these\nrequirements may significantly impact the user experience and will almost\ncertainly block the usage of the codec.\n\n| Parameter | Requirement |\n|----------------------------------------------|-----------------------------------------------|\n| Maximum inter frame processing time, seconds | ≤ `1 / max(30, encode_target_frame_rate_fps)` |\n| Maximum key frame processing time, seconds | ≤ `2 / max(30, encode_target_frame_rate_fps)` |\n\nThe frame processing time is the time difference between two events: 1) codec\ndelivers the frame and 2) codec receives the frame. The average frame processing\ntime is calculated over a sliding window of at least **10 seconds** duration\nholding at least **10 frames**. The maximum frame processing time is the highest\nvalue among all individual frame processing time values.\n\nThe throughput is calculated as the number of processed frames, including\ndropped ones, divided by time delta between the two events: 1) codec delivers\nthe last frame and 2) codec delivers the first frame.\n\nTest cases\n----------\n\nThe following are test cases you can use:\n\n| Tests |\n|----------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Decode throughput | Decode up to three 2880 × 1880 × 30 streams simultaneously and verify that decoders don't violate the performance requirements. |\n| Decoder conformance | Decode a set of pre-encoded bitstreams. The output of the test decoder must match the output of a reference decoder (`libvpx` for VP8 \\& VP9, `libaom` for AV1). |\n| Temporal scalability | Decode video with multiple temporal layers (2 and 3). The output of the test decoder must match the output of the reference decoder. |\n| Spatial scalability | Decode video with multiple spatial layers (2 and 3). The output of the test decoder must match the output of the reference decoder. |\n\nRelated topics\n--------------\n\n- [Get started with Meet Media API](/workspace/meet/media-api/guides/get-started)"]]
