با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
سرویس گیرندگان Google Meet Media API باید به صورت دوره‌ای آمار سرویس گیرنده را در کانال داده آمار media-stats آپلود کنند.
ورودی های مورد نیاز Meet Media API زیرمجموعه ای از آمار جمع آوری شده توسط WebRTC هستند که با فراخوانی متد RTCPeerConnection::getStats() قابل دسترسی هستند.
جریان مشتری
همه سرویس گیرندگان Meet Media API باید جریان زیر را اجرا کنند.
پیکربندی اولیه
پس از اینکه کلاینت کانال داده media-stats را باز کرد، Meet فوراً یک به‌روزرسانی منبع MediaStatsConfiguration را روی کانال ارسال می‌کند. این پیکربندی مشخص می کند که سرویس گیرنده چگونه باید آمار را آپلود کند.
تاریخ آخرین به‌روزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Upload client metrics to the 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\nGoogle Meet Media API clients must periodically upload client statistics over\nthe `media-stats` data channel.\n\nThe entries required by the Meet Media API are a subset of the\n[statistics](https://w3c.github.io/webrtc-pc/#mandatory-to-implement-stats)\ngathered by WebRTC, which are accessible by calling the\n`RTCPeerConnection::getStats()` method.\n\nClient flow\n-----------\n\nAll Meet Media API clients must implement the following flow.\n| **Tip:** The provided reference clients ([C++](/workspace/meet/media-api/guides/cpp), [TypeScript](/workspace/meet/media-api/guides/ts)) show how to implement this flow.\n\n### Initial configuration\n\nAfter the client opens the `media-stats` data channel, Meet\nimmediately sends a\n[`MediaStatsConfiguration`](/workspace/meet/media-api/reference/dc/media_api.mediastatsconfiguration)\nresource update over the channel. This configuration specifies how the client\nshould upload stats.\n\n| Configuration |\n|---------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------|\n| [`uploadIntervalSeconds`](/workspace/meet/media-api/reference/dc/media_api.mediastatsconfiguration.uploadintervalseconds) | Specifies how frequently the Meet Media API client should upload statistics, or zero if the client shouldn't upload any. |\n| [`allowlist`](/workspace/meet/media-api/reference/dc/media_api.mediastatsconfiguration.allowlist) | Specifies which `RTCPeerConnection::getStats()` entries the client should upload. |\n\n### Stats upload\n\nWhile connected to a conference, the Meet Media API client must:\n\n1. Call the `RTCPeerConnection::getStats()` method at the interval specified by\n [`uploadIntervalSeconds`](/workspace/meet/media-api/reference/dc/media_api.mediastatsconfiguration.uploadintervalseconds).\n\n2. Filter the resulting stats object down to the fields specified by\n [`allowlist`](/workspace/meet/media-api/reference/dc/media_api.mediastatsconfiguration.allowlist).\n\n3. Upload the filtered stats by sending a [`UploadMediaStatsRequest`](/workspace/meet/media-api/reference/dc/media_api.uploadmediastatsrequest)\n across the `media-stats` data channel.\n\nRelated topics\n--------------\n\n- [Meet Media API concepts](/workspace/meet/media-api/guides/concepts)\n- [Get started with Meet Media API](/workspace/meet/media-api/guides/get-started)"]]
