کنترل‌های رسانه در رابط کاربری سیستم

از Android 13، کنترل‌های رسانه در System UI حاوی به‌روزرسانی‌هایی برای دکمه‌های عملکرد و پخش از راه دور هستند. این تغییرات از تجربه کنترل رسانه‌ای صیقلی‌تر در تلفن‌ها و تبلت‌ها پشتیبانی می‌کنند و انتقال رسانه‌ای بدون درز را در بین دستگاه‌ها ارائه می‌دهند.

به‌روزرسانی‌های کنترل‌های رسانه

این بخش به‌روزرسانی‌های انجام‌شده برای کنترل‌های رسانه در Android 13 را برای دکمه‌های عملکرد و پخش از راه دور توضیح می‌دهد.

دکمه اکشن تغییر می کند

برای اطمینان از اینکه کاربران می‌توانند به مجموعه‌ای غنی از کنترل‌های رسانه برای برنامه‌هایی که رسانه پخش می‌کنند دسترسی داشته باشند، دکمه‌های عملکرد روی کنترل‌های رسانه برای Android 13 از حالت‌های عملکرد PlaybackState مشتق شده‌اند. با این تغییر، تابع MediaDataManager#createActionsFromState اطلاعات دکمه عمل را بر اساس وضعیت عملکرد PlaybackState تولید می کند. این با نحوه نمایش کنترل‌های رسانه در دیگر پلت‌فرم‌های Android مانند Auto، Assistant و Wear مطابقت دارد.

در مقابل، در اندروید 12، دکمه‌های کنش روی کنترل‌های رسانه با اعمال اعلان اضافه شده به اعلان MediaStyle تعیین می‌شوند.

برای خلاصه‌ای از تغییرات سازگار با برنامه برای به‌روزرسانی‌های دکمه عمل، StatusBarManager ببینید.

API پخش از راه دور

برای ارائه یک تجربه رسانه ای منسجم در سطوح مختلف، با شروع Android 13، یک سیستم جدید API Notification#setRemotePlaybackInfo اضافه شده است تا اعلان های رسانه را در رابط کاربری سیستم کنترل رسانه برای پخش از راه دور علامت گذاری کند. این API به برنامه‌های سیستمی که اعلان‌ها را ارسال می‌کنند اجازه می‌دهد کارهای زیر را انجام دهند:

• اطلاعات و عملکرد را برای رسانه‌ای که از یک دستگاه راه دور ایجاد می‌شود به سوئیچ‌کننده خروجی پیش‌فرض در کنترل رسانه ارائه کنید.
• در صورت لزوم affordance سوییچر خروجی را تعویض کنید.

برنامه‌های سیستمی که از این اعلان استفاده می‌کنند باید مجوز MEDIA_CONTENT_CONTROL را داشته باشند.

Notification#setRemotePlaybackInfo API همچنین extras زیر را برای تعیین نام، نماد و هدف دستگاه پخش از راه دور اضافه می کند:

• Notification#EXTRA_MEDIA_REMOTE_DEVICE
• Notification#EXTRA_MEDIA_REMOTE_ICON
• Notification#EXTRA_MEDIA_REMOTE_INTENT

با این اطلاعات، System UI می‌تواند اطلاعات دستگاه تراشه سوئیچر خروجی پیش‌فرض را جایگزین کند و کنترل رسانه برای پخش از راه دور را به انتهای فهرست کنترل‌های رسانه محلی اضافه کند.

اجرای کنترل رسانه ها

OEM ها باید از این تغییر در رفتار پیش فرض آگاه باشند، زیرا بر نحوه تولید کنترل های رسانه برای برنامه ها تأثیر می گذارد. OEM ها همچنین باید اطمینان حاصل کنند که API سیستم جدید در استطاعت سوئیچ کننده خروجی آنها به همان اندازه کار می کند.

OEM ها نیازی به ایجاد هیچ تغییری ندارند و می توانند از پیاده سازی پیش فرض در AOSP استفاده کنند.

سفارشی سازی پخش از راه دور

در مواردی که OEM دارای یک برنامه سیستمی است که اعلان‌های پخش رسانه از راه دور را ارسال می‌کند، تا زمانی که مجوز MEDIA_CONTENT_CONTROL به آن داده شده باشد، برنامه می‌تواند به صورت اختیاری برای اطلاع رسانی setRemotePlaybackInfo تماس بگیرد. با این حال، این یک الزام نیست و شریک می تواند انتخاب کند که سفارشی نشود.

اعتبار سنجی کنترل رسانه ها

برای آزمایش کنترل رسانه در رابط کاربری سیستم، یک آزمایش دستی برای تأیید اعتبار موارد زیر اجرا کنید:

• هنگام پخش رسانه از یک برنامه، دکمه ها همانطور که در نظر گرفته شده است عمل می کنند.
• سوئیچر خروجی اطلاعات صحیح دستگاه را نمایش می دهد.

برای تأیید اعتبار API پخش از راه دور از آزمایش‌های زیر استفاده کنید:

• تست های CTS در NotificationManagerTest ، مانند testMediaStyleRemotePlayback_noPermission و testMediaStyleRemotePlayback_hasPermission .
• تست های واحد تحت com.android.systemui.media .

برای توصیه ها به الزامات CDD جدید [3.8.3.1/H-1-SR] مراجعه کنید.

،

از Android 13، کنترل‌های رسانه در System UI حاوی به‌روزرسانی‌هایی برای دکمه‌های عملکرد و پخش از راه دور هستند. این تغییرات از تجربه کنترل رسانه‌ای صیقلی‌تر در تلفن‌ها و تبلت‌ها پشتیبانی می‌کنند و انتقال رسانه‌ای بدون درز را در بین دستگاه‌ها ارائه می‌دهند.

به‌روزرسانی‌های کنترل‌های رسانه

این بخش به‌روزرسانی‌های انجام‌شده برای کنترل‌های رسانه در Android 13 را برای دکمه‌های عملکرد و پخش از راه دور توضیح می‌دهد.

دکمه اکشن تغییر می کند

برای اطمینان از اینکه کاربران می‌توانند به مجموعه‌ای غنی از کنترل‌های رسانه برای برنامه‌هایی که رسانه پخش می‌کنند دسترسی داشته باشند، دکمه‌های عملکرد روی کنترل‌های رسانه برای Android 13 از حالت‌های عملکرد PlaybackState مشتق شده‌اند. با این تغییر، تابع MediaDataManager#createActionsFromState اطلاعات دکمه عمل را بر اساس وضعیت عملکرد PlaybackState تولید می کند. این با نحوه نمایش کنترل‌های رسانه در دیگر پلت‌فرم‌های Android مانند Auto، Assistant و Wear مطابقت دارد.

در مقابل، در اندروید 12، دکمه‌های کنش روی کنترل‌های رسانه با اعمال اعلان اضافه شده به اعلان MediaStyle تعیین می‌شوند.

برای خلاصه‌ای از تغییرات سازگار با برنامه برای به‌روزرسانی‌های دکمه عمل، StatusBarManager ببینید.

API پخش از راه دور

برای ارائه یک تجربه رسانه ای منسجم در سطوح مختلف، با شروع Android 13، یک سیستم جدید API Notification#setRemotePlaybackInfo اضافه شده است تا اعلان های رسانه را در رابط کاربری سیستم کنترل رسانه برای پخش از راه دور علامت گذاری کند. این API به برنامه‌های سیستمی که اعلان‌ها را ارسال می‌کنند اجازه می‌دهد کارهای زیر را انجام دهند:

• اطلاعات و عملکرد را برای رسانه‌ای که از یک دستگاه راه دور ایجاد می‌شود به سوئیچ‌کننده خروجی پیش‌فرض در کنترل رسانه ارائه کنید.
• در صورت لزوم affordance سوییچر خروجی را تعویض کنید.

برنامه‌های سیستمی که از این اعلان استفاده می‌کنند باید مجوز MEDIA_CONTENT_CONTROL را داشته باشند.

Notification#setRemotePlaybackInfo API همچنین extras زیر را برای تعیین نام، نماد و هدف دستگاه پخش از راه دور اضافه می کند:

• Notification#EXTRA_MEDIA_REMOTE_DEVICE
• Notification#EXTRA_MEDIA_REMOTE_ICON
• Notification#EXTRA_MEDIA_REMOTE_INTENT

با این اطلاعات، System UI می‌تواند اطلاعات دستگاه تراشه سوئیچر خروجی پیش‌فرض را جایگزین کند و کنترل رسانه برای پخش از راه دور را به انتهای فهرست کنترل‌های رسانه محلی اضافه کند.

اجرای کنترل رسانه ها

OEM ها باید از این تغییر در رفتار پیش فرض آگاه باشند، زیرا بر نحوه تولید کنترل های رسانه برای برنامه ها تأثیر می گذارد. OEM ها همچنین باید اطمینان حاصل کنند که API سیستم جدید در استطاعت سوئیچ کننده خروجی آنها به همان اندازه کار می کند.

OEM ها نیازی به ایجاد هیچ تغییری ندارند و می توانند از پیاده سازی پیش فرض در AOSP استفاده کنند.

سفارشی سازی پخش از راه دور

در مواردی که OEM دارای یک برنامه سیستمی است که اعلان‌های پخش رسانه از راه دور را ارسال می‌کند، تا زمانی که مجوز MEDIA_CONTENT_CONTROL به آن داده شده باشد، برنامه می‌تواند به صورت اختیاری برای اطلاع رسانی setRemotePlaybackInfo تماس بگیرد. با این حال، این یک الزام نیست و شریک می تواند انتخاب کند که سفارشی نشود.

اعتبار سنجی کنترل رسانه ها

برای آزمایش کنترل رسانه در رابط کاربری سیستم، یک آزمایش دستی برای تأیید اعتبار موارد زیر اجرا کنید:

• هنگام پخش رسانه از یک برنامه، دکمه ها همانطور که در نظر گرفته شده است عمل می کنند.
• سوئیچر خروجی اطلاعات صحیح دستگاه را نمایش می دهد.

برای تأیید اعتبار API پخش از راه دور از آزمایش‌های زیر استفاده کنید:

• تست های CTS در NotificationManagerTest ، مانند testMediaStyleRemotePlayback_noPermission و testMediaStyleRemotePlayback_hasPermission .
• تست های واحد تحت com.android.systemui.media .

برای توصیه ها به الزامات CDD جدید [3.8.3.1/H-1-SR] مراجعه کنید.

،

از Android 13، کنترل‌های رسانه در System UI حاوی به‌روزرسانی‌هایی برای دکمه‌های عملکرد و پخش از راه دور هستند. این تغییرات از تجربه کنترل رسانه‌ای صیقلی‌تر در تلفن‌ها و تبلت‌ها پشتیبانی می‌کنند و انتقال رسانه‌ای بدون درز را در بین دستگاه‌ها ارائه می‌دهند.

به‌روزرسانی‌های کنترل‌های رسانه

این بخش به‌روزرسانی‌های انجام‌شده برای کنترل‌های رسانه در Android 13 را برای دکمه‌های عملکرد و پخش از راه دور توضیح می‌دهد.

دکمه اکشن تغییر می کند

برای اطمینان از اینکه کاربران می‌توانند به مجموعه‌ای غنی از کنترل‌های رسانه برای برنامه‌هایی که رسانه پخش می‌کنند دسترسی داشته باشند، دکمه‌های عملکرد روی کنترل‌های رسانه برای Android 13 از حالت‌های عملکرد PlaybackState مشتق شده‌اند. با این تغییر، تابع MediaDataManager#createActionsFromState اطلاعات دکمه عمل را بر اساس وضعیت عملکرد PlaybackState تولید می کند. این با نحوه نمایش کنترل‌های رسانه در دیگر پلت‌فرم‌های Android مانند Auto، Assistant و Wear مطابقت دارد.

در مقابل، در اندروید 12، دکمه‌های کنش روی کنترل‌های رسانه با اعمال اعلان اضافه شده به اعلان MediaStyle تعیین می‌شوند.

برای خلاصه‌ای از تغییرات سازگار با برنامه برای به‌روزرسانی‌های دکمه عمل، StatusBarManager ببینید.

API پخش از راه دور

برای ارائه یک تجربه رسانه ای منسجم در سطوح مختلف، با شروع Android 13، یک سیستم جدید API Notification#setRemotePlaybackInfo اضافه شده است تا اعلان های رسانه را در رابط کاربری سیستم کنترل رسانه برای پخش از راه دور علامت گذاری کند. این API به برنامه‌های سیستمی که اعلان‌ها را ارسال می‌کنند اجازه می‌دهد کارهای زیر را انجام دهند:

• اطلاعات و عملکرد را برای رسانه‌ای که از یک دستگاه راه دور ایجاد می‌شود به سوئیچ‌کننده خروجی پیش‌فرض در کنترل رسانه ارائه کنید.
• در صورت لزوم affordance سوییچر خروجی را تعویض کنید.

برنامه‌های سیستمی که از این اعلان استفاده می‌کنند باید مجوز MEDIA_CONTENT_CONTROL را داشته باشند.

Notification#setRemotePlaybackInfo API همچنین extras زیر را برای تعیین نام، نماد و هدف دستگاه پخش از راه دور اضافه می کند:

• Notification#EXTRA_MEDIA_REMOTE_DEVICE
• Notification#EXTRA_MEDIA_REMOTE_ICON
• Notification#EXTRA_MEDIA_REMOTE_INTENT

با این اطلاعات، System UI می‌تواند اطلاعات دستگاه تراشه سوئیچر خروجی پیش‌فرض را جایگزین کند و کنترل رسانه برای پخش از راه دور را به انتهای فهرست کنترل‌های رسانه محلی اضافه کند.

اجرای کنترل رسانه ها

OEM ها باید از این تغییر در رفتار پیش فرض آگاه باشند، زیرا بر نحوه تولید کنترل های رسانه برای برنامه ها تأثیر می گذارد. OEM ها همچنین باید اطمینان حاصل کنند که API سیستم جدید در استطاعت سوئیچ کننده خروجی آنها به همان اندازه کار می کند.

OEM ها نیازی به ایجاد هیچ تغییری ندارند و می توانند از پیاده سازی پیش فرض در AOSP استفاده کنند.

سفارشی سازی پخش از راه دور

در مواردی که OEM دارای یک برنامه سیستمی است که اعلان‌های پخش رسانه از راه دور را ارسال می‌کند، تا زمانی که مجوز MEDIA_CONTENT_CONTROL به آن داده شده باشد، برنامه می‌تواند به صورت اختیاری برای اطلاع رسانی setRemotePlaybackInfo تماس بگیرد. با این حال، این یک الزام نیست و شریک می تواند انتخاب کند که سفارشی نشود.

اعتبار سنجی کنترل رسانه ها

برای آزمایش کنترل رسانه در رابط کاربری سیستم، یک آزمایش دستی برای تأیید اعتبار موارد زیر اجرا کنید:

• هنگام پخش رسانه از یک برنامه، دکمه ها همانطور که در نظر گرفته شده است عمل می کنند.
• سوئیچر خروجی اطلاعات صحیح دستگاه را نمایش می دهد.

برای تأیید اعتبار API پخش از راه دور از آزمایش‌های زیر استفاده کنید:

• تست های CTS در NotificationManagerTest ، مانند testMediaStyleRemotePlayback_noPermission و testMediaStyleRemotePlayback_hasPermission .
• تست های واحد تحت com.android.systemui.media .

برای توصیه ها به الزامات CDD جدید [3.8.3.1/H-1-SR] مراجعه کنید.