קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בדף הזה מפורטות הדרישות הבסיסיות לקודקים של וידאו בלקוח של Google Meet Media API, כדי להבטיח חוויית משתמש טובה.
דרישות פונקציונליות
בקטע הזה מפורטות הדרישות לגבי סוגי קודקים ותכונות.
תכונה
דרישה
פרופיל
AV1
VP9
VP8
Main
Profile 0
לא רלוונטי
מדרגיות
המפענח צריך לתמוך בהתאמה זמנית, בהתאמה מרחבית או בשניהם, אם נדרש על ידי
מפרט הקידוד עבור סוג ופרופיל נתון של קודק.
פורמט הווידאו הגולמי
הקודק צריך להיות מסוגל לעבד רזולוציות אי-זוגיות (למשל, כשהרוחב או הגובה של הפריימים לא מתחלקים ב-2, כמו 133 × 141). בפורמטים של דגימת משנה של כרומה, מספר הדגימות של הכרומה לכל ממד צריך להיות מעוגל כלפי מעלה כשמפיקים אותו ממספר הדגימות של הבהירות.
אסור לבצע חיתוך, הוספת שוליים או שינוי גודל. הרזולוציה של פריים הפלט חייבת להיות זהה לרזולוציה של פריים הקלט.
דרישות תפעוליות
בקטע הזה מפורטות הדרישות לתנאים שונים שבהם קודק הווידאו אמור לפעול. הפרה של הדרישות האלה עלולה להגביל את השימוש בקודק לתת-קבוצה של תרחישים, אבל לא בהכרח למנוע את השימוש בו. לדוגמה, אם מספר המקרים המקסימלי של קודק נמוך מהמספר הנדרש, עדיין אפשר להשתמש בקודק בשילוב עם קודקים מסוגים או מיישומים אחרים.
פרמטר
דרישה
רזולוציה מינימלית, פיקסלים
≤ 128 × 128
רזולוציה מקסימלית, פיקסלים
≥ 2,880 × 1,800
קצב פריימים מינימלי, FPS
≤ 1
קצב פריימים מקסימלי, FPS
≥ 30
הקצב המינימלי של העברת הנתונים, ביחידות kbps
≤ 30
קצב העברת נתונים מקסימלי, kbps
≥ 5,000
מספר מקסימלי של מופעי מפענח
≥ 3
התפוקה המקסימלית הכוללת של פענוח, פיקסלים לשנייה
≥ 3 × 2880 × 1880 × 30
דרישות ביצועים
בקטע הזה מפורטות הדרישות לגבי ביצועי קודק. הפרה של הדרישות האלה עלולה לפגוע באופן משמעותי בחוויית המשתמש, וכמעט בוודאות תגרום לחסימת השימוש ב-Codec.
פרמטר
דרישה
זמן עיבוד מקסימלי בין פריים לפריים, שניות
≤ 1 / max(30, encode_target_frame_rate_fps)
זמן העיבוד המקסימלי של תמונת מפתח, שניות
≤ 2 / max(30, encode_target_frame_rate_fps)
זמן העיבוד של הפריים הוא ההפרש בין שני אירועים: 1) קודק
מעביר את הפריים ו-2) קודק מקבל את הפריים. זמן העיבוד הממוצע של הפריימים מחושב על חלון הזזה של לפחות 10 שניות, שמכיל לפחות 10 פריימים. זמן העיבוד המקסימלי של הפריים הוא הערך הכי גבוה מבין כל ערכי זמן העיבוד של הפריים.
התפוקה מחושבת כמספר המסגרות שעברו עיבוד, כולל אלה שהושמטו, חלקי הפרש הזמן בין שני האירועים: 1) קודק מעביר את המסגרת האחרונה ו-2) קודק מעביר את המסגרת הראשונה.
מקרי בדיקה
אלה תרחישי בדיקה שאפשר להשתמש בהם:
בדיקות
תפוקת פענוח
לפענח עד שלושה זרמים של 2880 × 1880 × 30 בו-זמנית ולוודא שהמפענחים לא חורגים מדרישות הביצועים.
תאימות של מפענח הקוד
פענוח של קבוצת זרמי ביטים שעברו קידוד מראש. הפלט של מפענח הבדיקה חייב להיות זהה לפלט
של מפענח ייחוס (libvpx עבור VP8 ו-VP9, libaom עבור AV1).
מדרגיות זמנית
פענוח של סרטון עם כמה שכבות זמניות (2 ו-3). הפלט של מפענח הבדיקה חייב להיות זהה לפלט של מפענח ההפניה.
מדרגיות מרחבית
פענוח של סרטון עם כמה שכבות מרחביות (2 ו-3). הפלט של מפענח הבדיקה חייב להיות זהה לפלט של מפענח ההפניה.
[null,null,["עדכון אחרון: 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)"]]