قالب. چارچوب . (cast. framework) سیستم
این فضای نام cast.framework.system است.
کلاسها
دادههای کاربردی
فرادادهای که دادههای برنامهی اجرا شده را توصیف میکند.
رویداد
رویدادی که توسط cast.framework.CastReceiverContext ارسال میشود و حاوی اطلاعات سیستم است.
بازخوردآغاز رویداد
رویدادی که توسط cast.framework.CastReceiverContext ارسال میشود، زمانی که سیستم شروع به ایجاد گزارش بازخورد میکند.
رویداد MaxVideoResolutionChanged
رویدادی که توسط cast.framework.CastReceiverContext ارسال میشود، زمانی که سیستم نیاز به بهروزرسانی محدودیت حداکثر وضوح تصویر دارد.
پیام
یک پیام سفارشی که از یک فرستنده دریافت شده است. برای گوش دادن به رویدادهای سفارشی از متد cast.framework.CastReceiverContext#addCustomMessageListener استفاده کنید.
رویداد آماده
رویدادی که توسط cast.framework.CastReceiverContext هنگام آماده بودن سیستم ارسال میشود.
فرستنده
این نشان دهنده دادههای یک دستگاه فرستنده متصل است.
رویداد متصل به فرستنده
رویدادی که توسط cast.framework.CastReceiverContext هنگام اتصال یک فرستنده ارسال میشود.
رویداد قطع ارتباط فرستنده
رویدادی که توسط cast.framework.CastReceiverContext هنگام قطع ارتباط فرستنده ارسال میشود.
رویداد خاموشی
رویدادی که توسط cast.framework.CastReceiverContext هنگام خاموش شدن برنامه ارسال میشود.
رویداد StandbyChanged
رویدادی که توسط cast.framework.CastReceiverContext ارسال میشود، زمانی که تلویزیون وارد حالت آماده به کار میشود یا از آن خارج میشود، بنابراین برنامه باید همیشه ویژگی isStandby را تأیید کند. برای اطلاع از اینکه آیا وضعیت واقعی ناشناخته است، برنامه میتواند متد cast.framework.CastReceiverContext#getStandbyState را فراخوانی کند.
رویداد تغییر حجم سیستم
رویدادی که توسط cast.framework.CastReceiverContext هنگام تغییر حجم سیستم ارسال میشود.
دادههای حجم سیستم
این نشان دهنده داده های حجم سیستم است.
رویداد تغییر قابلیت مشاهده
رویدادی که توسط cast.framework.CastReceiverContext ارسال میشود، زمانی که قابلیت مشاهدهی برنامه تغییر میکند - برای مثال، وقتی ورودی HDMI تغییر میکند یا تلویزیون خاموش میشود.
شمارشها
قابلیتهای دستگاه
رشته
قابلیتهای تنظیمات فعلی را شرح میدهد، که شامل دستگاه دارای قابلیت Cast و در صورت لزوم، دستگاه نمایشگری که به آن متصل است، میشود.
ارزش | |
|---|---|
دستیار صوتی | رشته پشتیبانی از دستیار صوتی. نمونههایی از دستگاههای دارای قابلیت Cast با پشتیبانی از دستیار صوتی شامل Google Home و Google Home Mini است. |
پشتیبانی از بلوتوث | رشته پشتیبانی از بلوتوث. |
پشتیبانی از نمایشگر | رشته پشتیبانی از خروجی نمایشگر. نمونههایی از دستگاههای دارای قابلیت Cast با پشتیبانی از نمایشگر شامل Chromecast و Cast TVs هستند. نمونههایی از دستگاههای دارای قابلیت Cast که فاقد پشتیبانی از نمایشگر هستند شامل Chromecast Audio و Google Home هستند. |
پشتیبانی از صدای با کیفیت بالا | رشته پشتیبانی از صدای با وضوح بالا (تا 24 بیت / 96 کیلوهرتز). |
IS_DV_پشتیبانی میشود | رشته پشتیبانی از دالبی ویژن |
پشتیبانی از HDR | رشته پشتیبانی از ویدئوهای HDR. |
فقط بازیگران سبک | رشته اینکه آیا این دستگاه روی یک پلتفرم فقط صوتی اجرا میشود یا خیر. ممکن است برخی از APIها به طور کامل در چنین پلتفرمهایی پشتیبانی نشوند. |
ورودی DPAD پشتیبانی میشود | رشته اینکه آیا این دستگاه از مکانیزم ورودی، مانند باز کردن قفل DPAD، پشتیبانی میکند یا خیر. |
ورودی لمسی پشتیبانی میشود | رشته پشتیبانی از ورودی لمسی. نمونههایی از دستگاههای دارای قابلیت Cast که از ورودی لمسی پشتیبانی میکنند عبارتند از Google Nest Hub و Google Nest Hub Max. |
گروه IS | رشته اگر دستگاه یک دستگاه مجازی باشد و به جای یک دستگاه فیزیکی، یک هدف گروهی را نشان دهد. |
دستگاه ثبت شده است | رشته وقتی روی |
IS_CBCS_SUPPORTED | رشته وقتی روی |
IS_DOLBY_ATMOS_پشتیبانی میشود | رشته وقتی روی |
اطلاعات دستگاه
رشته
ثابتهایی برای کلیدهای معتبر در cast.framework.CastReceiverContext.DeviceInformationObj.
ارزش | |
|---|---|
نام مدل | رشته نام مدل دستگاه (مثلاً: Google TV Streamer، Nest Hub، Nest Mini و غیره) در صورت مشخص بودن. در صورت نامشخص بودن، «نامشخص». |
نام تجاری | رشته نام برند دستگاه (مثلاً گوگل، الجی، سونی و غیره) در صورت مشخص بودن. در صورت نامشخص بودن، یک رشته خالی. |
نام سیستم عامل | رشته نام سیستم عامل دستگاه (مثلاً: اندروید، فوشیا، لینوکس و غیره) در صورت مشخص بودن. در صورت مشخص نبودن، یک رشته خالی، یا در صورت عدم وجود قابلیت Cast، عبارت «not Cast» نمایش داده میشود. |
نسخه سیستم عامل | رشته نسخه سیستم عامل دستگاه (مثلاً: ۱۴.۰ و غیره) در صورت مشخص بودن. در صورت نامشخص بودن، یک رشته خالی. |
محیط زیست | رشته نوع محیطی که دستگاه در آن قرار دارد (مثلاً: خانه، خودرو، هواپیما، هتل و غیره) در صورت مشخص بودن. معمولاً برای اکثر دستگاهها «خانه» در نظر گرفته میشود. |
شناسه دستگاه | رشته شناسه منحصر به فرد دستگاه گیرنده، در صورت مشخص بودن. همان مقداری خواهد بود که شناسه گیرنده Cast توسط SDK فرستنده نمایش داده میشود. در صورت مشخص نبودن، یک رشته خالی. |
فراداده از میانافزار | رشته اینکه آیا اطلاعات دستگاه توسط میانافزار ارائه شده است یا خیر. |
دلیل قطع ارتباط
رشته
دلیل قطع ارتباط را نشان میدهد.
ارزش | |
|---|---|
درخواستشده توسط فرستنده | رشته درخواست قطع اتصال به طور فعال توسط برنامه فرستنده (که معمولاً توسط کاربر انجام میشود) انجام شده است. |
خطا | رشته یک خطای پروتکل رخ داده است. |
ناشناخته | رشته مشخص نیست که آیا فرستنده با فراخوانی تابع |
نوع رویداد
رشته
رویدادهای سیستم توسط cast.framework.CastReceiverContext ارسال میشوند.
ارزش | |
|---|---|
آماده | رشته وقتی سیستم آماده شد، فعال میشود. |
خاموشی | رشته هنگام خاتمه برنامه، اجرا میشود. |
فرستنده_متصل | رشته زمانی اجرا میشود که فرستنده جدیدی متصل شده باشد. |
فرستنده_قطع_ارتباط | رشته زمانی اجرا میشود که ارتباط فرستنده قطع شده باشد. |
خطا | رشته زمانی که خطای سیستمی رخ دهد، فعال میشود. |
حجم سیستم تغییر کرد | رشته زمانی اجرا میشود که صدای سیستم تغییر کرده باشد. |
تغییر در قابلیت مشاهده | رشته زمانی اجرا میشود که قابلیت مشاهدهی برنامه تغییر کرده باشد (برای مثال، پس از تغییر ورودی HDMI یا زمانی که تلویزیون خاموش یا روشن میشود و دستگاه Cast از منبع تغذیهی خارجی استفاده میکند). توجه داشته باشید که این API همان تأثیر رویداد 'webkitvisibilitychange' را که توسط مرورگر ایجاد میشود، دارد. این API برای راحتی و جلوگیری از وابستگی به یک رویداد با پیشوند webkit، به صورت cast.framework.CastReceiverContext ارائه شده است. |
حالت آماده به کار تغییر کرد | رشته زمانی اجرا میشود که وضعیت آماده به کار تلویزیون تغییر کند. این رویداد به رویداد cast.framework.system.EventType.VISIBILITY_CHANGED مربوط میشود، زیرا اگر تلویزیون در حالت آماده به کار باشد، میزان دید (visibility) حالتهای دید (visibility) نسبت به حالتهای آماده به کار (standby) جزئیات بیشتری دارند (زیرا قابلیت دید شامل انتخاب کانال تلویزیونی نیز میشود) اما در همه تلویزیونها به طور قابل اعتمادی تشخیص داده نمیشوند. در این موارد میتوان از حالت آماده به کار (standby) استفاده کرد زیرا اکثر تلویزیونها آن را پیادهسازی میکنند. |
حداکثر وضوح تصویر تغییر کرد | رشته |
بازخورد_شروع شد | رشته زمانی اجرا میشود که سیستم شروع به ایجاد گزارش بازخورد میکند. |
راه اندازی شده از
رشته
این نشان میدهد که چه نوع درخواستی گیرنده را راهاندازی کرده است.
ارزش | |
|---|---|
ناشناخته | رشته مالک پرتاب مشخص نشد. |
شماره گیری | رشته برنامه با درخواست DIAL راه اندازی شد. |
بازیگران | رشته برنامه با درخواست Cast V2 راه اندازی شد. |
ابر | رشته برنامه با درخواست دستیار (مثلاً با دستور دستیار گوگل) اجرا شد. |
نوع پیام
رشته
انواع پیامهای سفارشی
ارزش | |
|---|---|
رشته | رشته پیامها رشتههای آزاد هستند. برنامه مسئول رمزگذاری/رمزگشایی اطلاعات منتقل شده است. |
جیسون | رشته پیامها با JSON کدگذاری میشوند. انتقال زیربنایی از یک رشته کدگذاری شده با JSON استفاده خواهد کرد. |
حالت آماده به کار
رشته
این نشان دهنده وضعیت آماده به کار فعلی گزارش شده توسط پلتفرم است. اگر پلتفرم Cast قادر به تعیین وضعیت نباشد، ممکن است UNKNOWN باشد.
ارزش | |
|---|---|
آماده به کار | رشته |
آماده_به_کار نیست | رشته |
ناشناخته | رشته |
وضعیت سیستم
رشته
این نشان دهنده وضعیت فعلی سیستم است.
ارزش | |
|---|---|
شروع نشده | رشته هنوز درخواستی برای شروع برنامه داده نشده است. |
شروع_در_پیشزمینه | رشته برنامه شروع به کار میکند اما برای کاربر قابل مشاهده نیست. |
شروع | رشته درخواست در حال شروع است. |
آماده | رشته برنامه در پیشزمینه قرار دارد و آماده ارسال و دریافت پیام است. |
توقف در پسزمینه | رشته برنامه در حالی که در پسزمینه است، متوقف میشود. |
توقف | رشته برنامه در حال توقف است. |
وضعیت دید
رشته
این نشان دهنده وضعیت فعلی مشاهدهپذیری گزارش شده توسط پلتفرم است. اگر پلتفرم Cast قادر به تعیین وضعیت مشاهدهپذیری نباشد، ممکن است UNKNOWN باشد.
ارزش | |
|---|---|
قابل مشاهده | رشته |
قابل مشاهده نیست | رشته |
ناشناخته | رشته |
خواص
قابلیتهای دستگاه
رشته
قابلیتهای تنظیمات فعلی را شرح میدهد، که شامل دستگاه دارای قابلیت Cast و در صورت لزوم، دستگاه نمایشگری که به آن متصل است، میشود.
ارزش | |
|---|---|
دستیار صوتی | رشته پشتیبانی از دستیار صوتی. نمونههایی از دستگاههای دارای قابلیت Cast با پشتیبانی از دستیار صوتی شامل Google Home و Google Home Mini است. |
پشتیبانی از بلوتوث | رشته پشتیبانی از بلوتوث. |
پشتیبانی از نمایشگر | رشته پشتیبانی از خروجی نمایشگر. نمونههایی از دستگاههای دارای قابلیت Cast با پشتیبانی از نمایشگر شامل Chromecast و Cast TVs هستند. نمونههایی از دستگاههای دارای قابلیت Cast که فاقد پشتیبانی از نمایشگر هستند شامل Chromecast Audio و Google Home هستند. |
پشتیبانی از صدای با کیفیت بالا | رشته پشتیبانی از صدای با وضوح بالا (تا 24 بیت / 96 کیلوهرتز). |
IS_DV_پشتیبانی میشود | رشته پشتیبانی از دالبی ویژن |
پشتیبانی از HDR | رشته پشتیبانی از ویدئوهای HDR. |
فقط بازیگران سبک | رشته اینکه آیا این دستگاه روی یک پلتفرم فقط صوتی اجرا میشود یا خیر. ممکن است برخی از APIها به طور کامل در چنین پلتفرمهایی پشتیبانی نشوند. |
ورودی DPAD پشتیبانی میشود | رشته اینکه آیا این دستگاه از مکانیزم ورودی، مانند باز کردن قفل DPAD، پشتیبانی میکند یا خیر. |
ورودی لمسی پشتیبانی میشود | رشته پشتیبانی از ورودی لمسی. نمونههایی از دستگاههای دارای قابلیت Cast که از ورودی لمسی پشتیبانی میکنند عبارتند از Google Nest Hub و Google Nest Hub Max. |
گروه IS | رشته اگر دستگاه یک دستگاه مجازی باشد و به جای یک دستگاه فیزیکی، یک هدف گروهی را نشان دهد. |
دستگاه ثبت شده است | رشته وقتی روی |
IS_CBCS_SUPPORTED | رشته وقتی روی |
IS_DOLBY_ATMOS_پشتیبانی میشود | رشته وقتی روی |
اطلاعات دستگاه
رشته
ثابتهایی برای کلیدهای معتبر در cast.framework.CastReceiverContext.DeviceInformationObj.
ارزش | |
|---|---|
نام مدل | رشته نام مدل دستگاه (مثلاً: Google TV Streamer، Nest Hub، Nest Mini و غیره) در صورت مشخص بودن. در صورت نامشخص بودن، «نامشخص». |
نام تجاری | رشته نام برند دستگاه (مثلاً گوگل، الجی، سونی و غیره) در صورت مشخص بودن. در صورت نامشخص بودن، یک رشته خالی. |
نام سیستم عامل | رشته نام سیستم عامل دستگاه (مثلاً: اندروید، فوشیا، لینوکس و غیره) در صورت مشخص بودن. در صورت مشخص نبودن، یک رشته خالی، یا در صورت عدم وجود قابلیت Cast، عبارت «not Cast» نمایش داده میشود. |
نسخه سیستم عامل | رشته نسخه سیستم عامل دستگاه (مثلاً: ۱۴.۰ و غیره) در صورت مشخص بودن. در صورت نامشخص بودن، یک رشته خالی. |
محیط زیست | رشته نوع محیطی که دستگاه در آن قرار دارد (مثلاً: خانه، خودرو، هواپیما، هتل و غیره) در صورت مشخص بودن. معمولاً برای اکثر دستگاهها «خانه» در نظر گرفته میشود. |
شناسه دستگاه | رشته شناسه منحصر به فرد دستگاه گیرنده، در صورت مشخص بودن. همان مقداری خواهد بود که شناسه گیرنده Cast توسط SDK فرستنده نمایش داده میشود. در صورت مشخص نبودن، یک رشته خالی. |
فراداده از میانافزار | رشته اینکه آیا اطلاعات دستگاه توسط میانافزار ارائه شده است یا خیر. |
دلیل قطع ارتباط
رشته
دلیل قطع ارتباط را نشان میدهد.
ارزش | |
|---|---|
درخواستشده توسط فرستنده | رشته درخواست قطع اتصال به طور فعال توسط برنامه فرستنده (که معمولاً توسط کاربر انجام میشود) انجام شده است. |
خطا | رشته یک خطای پروتکل رخ داده است. |
ناشناخته | رشته مشخص نیست که آیا فرستنده با فراخوانی تابع |
نوع رویداد
رشته
رویدادهای سیستم توسط cast.framework.CastReceiverContext ارسال میشوند.
ارزش | |
|---|---|
آماده | رشته وقتی سیستم آماده شد، فعال میشود. |
خاموشی | رشته هنگام خاتمه برنامه، اجرا میشود. |
فرستنده_متصل | رشته زمانی اجرا میشود که فرستنده جدیدی متصل شده باشد. |
فرستنده_قطع_ارتباط | رشته زمانی اجرا میشود که ارتباط فرستنده قطع شده باشد. |
خطا | رشته زمانی که خطای سیستمی رخ دهد، فعال میشود. |
حجم سیستم تغییر کرد | رشته زمانی اجرا میشود که صدای سیستم تغییر کرده باشد. |
تغییر در قابلیت مشاهده | رشته زمانی اجرا میشود که قابلیت مشاهدهی برنامه تغییر کرده باشد (برای مثال، پس از تغییر ورودی HDMI یا زمانی که تلویزیون خاموش یا روشن میشود و دستگاه Cast از منبع تغذیهی خارجی استفاده میکند). توجه داشته باشید که این API همان تأثیر رویداد 'webkitvisibilitychange' را که توسط مرورگر ایجاد میشود، دارد. این API برای راحتی و جلوگیری از وابستگی به یک رویداد با پیشوند webkit، به صورت cast.framework.CastReceiverContext ارائه شده است. |
حالت آماده به کار تغییر کرد | رشته زمانی اجرا میشود که وضعیت آماده به کار تلویزیون تغییر کند. این رویداد به رویداد cast.framework.system.EventType.VISIBILITY_CHANGED مربوط میشود، زیرا اگر تلویزیون در حالت آماده به کار باشد، میزان دید (visibility) حالتهای دید (visibility) نسبت به حالتهای آماده به کار (standby) جزئیات بیشتری دارند (زیرا قابلیت دید شامل انتخاب کانال تلویزیونی نیز میشود) اما در همه تلویزیونها به طور قابل اعتمادی تشخیص داده نمیشوند. در این موارد میتوان از حالت آماده به کار (standby) استفاده کرد زیرا اکثر تلویزیونها آن را پیادهسازی میکنند. |
حداکثر وضوح تصویر تغییر کرد | رشته |
بازخورد_شروع شد | رشته زمانی اجرا میشود که سیستم شروع به ایجاد گزارش بازخورد میکند. |
راه اندازی شده از
رشته
این نشان میدهد که چه نوع درخواستی گیرنده را راهاندازی کرده است.
ارزش | |
|---|---|
ناشناخته | رشته مالک پرتاب مشخص نشد. |
شماره گیری | رشته برنامه با درخواست DIAL راه اندازی شد. |
بازیگران | رشته برنامه با درخواست Cast V2 راه اندازی شد. |
ابر | رشته برنامه با درخواست دستیار (مثلاً با دستور دستیار گوگل) اجرا شد. |
نوع پیام
رشته
انواع پیامهای سفارشی
ارزش | |
|---|---|
رشته | رشته پیامها رشتههای آزاد هستند. برنامه مسئول رمزگذاری/رمزگشایی اطلاعات منتقل شده است. |
جیسون | رشته پیامها با JSON کدگذاری میشوند. انتقال زیربنایی از یک رشته کدگذاری شده با JSON استفاده خواهد کرد. |
حالت آماده به کار
رشته
این نشان دهنده وضعیت آماده به کار فعلی گزارش شده توسط پلتفرم است. اگر پلتفرم Cast قادر به تعیین وضعیت نباشد، ممکن است UNKNOWN باشد.
ارزش | |
|---|---|
آماده به کار | رشته |
آماده_به_کار نیست | رشته |
ناشناخته | رشته |
وضعیت سیستم
رشته
این نشان دهنده وضعیت فعلی سیستم است.
ارزش | |
|---|---|
شروع نشده | رشته هنوز درخواستی برای شروع برنامه داده نشده است. |
شروع_در_پیشزمینه | رشته برنامه شروع به کار میکند اما برای کاربر قابل مشاهده نیست. |
شروع | رشته درخواست در حال شروع است. |
آماده | رشته برنامه در پیشزمینه قرار دارد و آماده ارسال و دریافت پیام است. |
توقف در پسزمینه | رشته برنامه در حالی که در پسزمینه است، متوقف میشود. |
توقف | رشته برنامه در حال توقف است. |
وضعیت دید
رشته
این نشان دهنده وضعیت فعلی مشاهدهپذیری گزارش شده توسط پلتفرم است. اگر پلتفرم Cast قادر به تعیین وضعیت مشاهدهپذیری نباشد، ممکن است UNKNOWN باشد.
ارزش | |
|---|---|
قابل مشاهده | رشته |
قابل مشاهده نیست | رشته |
ناشناخته | رشته |
انواع انتزاعی
DeviceCapabilitiesObj
{audio_assistant: (boolean یا undefined)، bluetooth_supported: (boolean یا undefined)، display_supported: (boolean یا undefined)، hi_res_audio_supported: (boolean یا undefined)، is_dv_supported: (boolean یا undefined)، is_hdr_supported: (boolean یا undefined)، cast_lite_only: (boolean یا undefined)، dpad_input_supported: (boolean یا undefined)، touch_input_supported: (boolean یا undefined)، is_group: (boolean یا undefined)، remote_control_overlay_supported: (boolean یا undefined)، sleep_timer_overlay_supported: (boolean یا undefined)، app_foreground: (boolean یا undefined)، is_device_registered: (boolean یا undefined)، is_cbcs_supported: (boolean یا undefined)، is_dolby_atmos_supported: (boolean یا undefined)}
شیء برگردانده شده توسط getDeviceCapabilities را توصیف میکند.
- همچنین ببینید
- قابلیتهای دستگاه سیستم.چارچوب.ریختهگری
اطلاعات دستگاهObj
{نام مدل: رشته، نام تجاری: رشته، نام سیستم عامل: رشته، نسخه سیستم عامل: رشته، محیط: رشته، شناسه دستگاه: رشته، فراداده از سیستم عامل: بولی}
شیء برگردانده شده توسط getDeviceInformation را توصیف میکند.
- همچنین ببینید
- اطلاعات دستگاه سیستم.چارچوب.ریختهگری