Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu sayfada, iyi bir kullanıcı deneyimi sağlamak için Google Meet Media API istemci video codec'leriyle ilgili temel şartlar açıklanmaktadır.
İşlevsel şartlar
Bu bölümde, codec türleri ve özellikleri için gerekenler belirtilir.
Özellik
Gereksinim
Profil
AV1
VP9
VP8
Main
Profile 0
Yok
Ölçeklenebilirlik
Belirli bir codec türü ve profili için kodlama spesifikasyonu gerektiriyorsa kod çözücü, zamansal ölçeklenebilirliği, mekansal ölçeklenebilirliği veya her ikisini de desteklemelidir.
Ham video biçimi
Codec, tek çözünürlükleri (ör. kare genişliği veya yüksekliği 2'nin katı olmadığında; örneğin 133 × 141) işleyebilmelidir. Alt örneklenmiş kroma biçimlerinde, boyut başına kroma örneklerinin sayısı, luma örneklerinin sayısından türetildiğinde yukarı yuvarlanmalıdır.
Kırpma, dolgu veya ölçeklendirmeye izin verilmez. Çıkış karesinin çözünürlüğü, giriş karesinin çözünürlüğüyle eşleşmelidir.
Operasyonel şartlar
Bu bölümde, video codec'inin çalışması beklenen çeşitli koşullara ilişkin şartlar belirtilir. Bu koşulların ihlali, codec'in kullanımını senaryoların bir alt kümesiyle sınırlayabilir ancak kullanılmasını mutlaka engellemez. Örneğin, maksimum codec örneği sayısı gerekenden azsa codec, diğer tür veya uygulamalardaki codec'lerle birlikte kullanılabilir.
Parametre
Gereksinim
Minimum çözünürlük, piksel
≤ 128 × 128
Maksimum çözünürlük (piksel)
≥ 2880 × 1800
Minimum kare hızı, FPS
≤ 1
Maksimum kare hızı, FPS
≥ 30
Minimum bit hızı, kb/sn
≤ 30
Maksimum bit hızı, kb/sn
≥ 5.000
Maksimum kod çözücü örneği sayısı
≥ 3
Maksimum toplam kod çözme işleme hızı, saniyede piksel sayısı
≥ 3 × 2880 × 1880 × 30
Performans koşulları
Bu bölümde, codec performansı ile ilgili şartlar belirtilmektedir. Bu şartların ihlal edilmesi, kullanıcı deneyimini önemli ölçüde etkileyebilir ve codec'in kullanımını neredeyse kesin olarak engeller.
Parametre
Gereksinim
Maksimum kareler arası işleme süresi (saniye)
≤ 1 / max(30, encode_target_frame_rate_fps)
Maksimum anahtar kare işleme süresi (saniye)
≤ 2 / max(30, encode_target_frame_rate_fps)
Kare işleme süresi, iki etkinlik arasındaki zaman farkıdır: 1) codec, kareyi teslim eder ve 2) codec, kareyi alır. Ortalama kare işleme süresi, en az 10 kare içeren ve en az 10 saniye süren kayan bir pencere üzerinden hesaplanır. Maksimum kare işleme süresi, tüm tek tek kare işleme süresi değerleri arasındaki en yüksek değerdir.
İşleme hızı, bırakılanlar da dahil olmak üzere işlenen kare sayısının, iki etkinlik arasındaki zaman farkına bölünmesiyle hesaplanır: 1) codec son kareyi teslim eder ve 2) codec ilk kareyi teslim eder.
Test durumları
Kullanabileceğiniz test senaryoları aşağıda verilmiştir:
Testler
Kod çözme işleme hızı
En fazla üç adet 2.880 × 1.880 × 30 akışı aynı anda çözün ve kod çözücülerin performans koşullarını ihlal etmediğini doğrulayın.
Kod çözücü uygunluğu
Önceden kodlanmış bir bit akımı grubunu çözün. Test kod çözücünün çıkışı, referans kod çözücünün çıkışıyla eşleşmelidir (VP8 ve VP9 için libvpx, AV1 için libaom).
Zamansal ölçeklenebilirlik
Birden fazla zamansal katman (2 ve 3) içeren videoları çözme Test kod çözücünün çıkışı, referans kod çözücünün çıkışıyla eşleşmelidir.
Mekansal ölçeklenebilirlik
Birden fazla uzamsal katman (2 ve 3) içeren videoları çözme Test kod çözücünün çıkışı, referans kod çözücünün çıkışıyla eşleşmelidir.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 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)"]]
