وضع مكبّر الصوت العمودي الديناميكي

يتوافق مع إطار عمل Android 14 وأجهزة الاستقبال الرقمية (STB) وأجهزة خدمة البث المباشر على الإنترنت (OTT) المزوّدة بمكبرات صوت مدمجة أو متصلة تكوينها بحيث تكون مكبّرات صوت عمودية للأجهزة المتصلة. وضع مكبّر الصوت العمودي الديناميكي يتوافق (DSM) في Android 14 مع مستهلك HDMI سمات التحكم في الأجهزة الإلكترونية (CEC) لمكبّرات الصوت العمودية، مثل قناة إرجاع الصوت (ARC) والتحكم في صوت النظام.

لا تستهدف هذه الميزة سوى أجهزة تشغيل Android TV CEC.

المتطلبات

لاستخدام ميزة مكبّر الصوت العمودي، يجب أن يستوفي المصنّعون الأصليون للأجهزة وواجهة مستخدم النظام. المتطلبات المدرجة في هذا القسم.

متطلبات الأجهزة

لدعم DSM، يجب أن يستوفي جهاز STB/OTT المتطلبات التالية:

  • يجب أن يعمل الجهاز بنظام التشغيل Android 14.
  • عند تمكين DSM، يجب أن يعمل الجهاز مثل مكبّر الصوت العمودي مواصفات HDMI CEC، مثل ARC
  • يجب أن يكون الجهاز قادرًا على تشغيل الصوت على الأجهزة المدمجة أو المتصلة المتحدثين.
  • إذا لم يكن الجهاز مصدرًا نشطًا، يجب إيقاف جميع الوسائط مؤقتًا على الجهاز، مما يحد من استهلاكه للطاقة.

متطلبات واجهة مستخدم النظام

لدعم DSM، يجب أن يفي المصنّعون الأصليون للأجهزة بالمتطلبات التالية أثناء تصميم واجهة مستخدم النظام:

  • يجب أن يتضمّن تصنيف واجهة المستخدم إشارة إلى ARC أو قناة إرجاع الصوت (ARC):
  • يجب أن تطلب واجهة المستخدم من المستخدم توصيل الجهاز بمنفذ "وقت تشغيل التطبيقات في Chrome" في التلفزيون لإنشاء اتصال ARC.
  • يجب أن تُعلم واجهة المستخدم المستخدم بأنّ الميزة قد لا تعمل على النحو المتوقّع إذا توصيل مكبّر صوت عمودي أو جهاز استقبال صوت/فيديو آخر في HDMI الشبكة.
  • يجب أن تُعلم واجهة المستخدم المستخدم بأنّ الشاشة قد تومض عند تبديل الإعداد.
  • إذا لم يكن الجهاز يحتوي على مكبرات صوت مدمَجة، فيجب إيقاف DSM تلقائيًا.

أفضل الممارسات: ننصح باستخدام الشاشة قائمة الصوت كموقع لإعداد المستخدم لتفعيل ARC أو إيقافه، كما هو موضّح في تنفيذ SysUI.

تنفيذ إطار العمل

تنفيذ وظيفة مكبّر صوت عمودي CEC والتخصيص الديناميكي العنوان المنطقي 5 موجود في إطار عمل Android. يخصص إطار العمل العنوان المنطقي عند تفعيل إعداد مكبّر الصوت العمودي، كي يتمكّن الجهاز من تصبح مكبّر صوت عموديًا بشكل ديناميكي. عند إيقاف إعداد مكبّر الصوت العمودي، يحدد العنوان المنطقي.

استنادًا إلى البيانات التي أدخلها المستخدم في واجهة مستخدم النظام، HdmiControlManager يُعيِّن CEC_SETTING_NAME_SOUNDBAR_MODE على SOUNDBAR_MODE_ENABLED أو SOUNDBAR_MODE_DISABLED القيمة التلقائية لـ CEC_SETTING_NAME_SOUNDBAR_MODE تم ضبطها على SOUNDBAR_MODE_DISABLED.

يرصد HdmiControlService التغيير في CEC_SETTING_NAME_SOUNDBAR_MODE. لإجراء ما يلي:

  • تحقَّق من توفُّر جهاز تشغيل محلي وأنّ الخاصية ARC
  • شغِّل تخصيص العنوان المنطقي لإضافة جهاز سماعي محلي أو إزالته.
  • تأكّد من الاحتفاظ بحالة الإعداد إذا كان الجهاز متصلاً بمصدر طاقة.

اطّلِع على النموذج التالي من نماذج البيانات التي يجب ضبطها والحصول على حالة وضع مكبّر الصوت العمودي:

    /**
     * Name of a setting deciding whether the Soundbar mode feature is enabled.
     * Before exposing this setting make sure the hardware supports it, otherwise, you may
     * experience multiple issues.
     *
     * @see HdmiControlManager#setSoundbarMode(int)
     */
    public static final String CEC_SETTING_NAME_SOUNDBAR_MODE = "soundbar_mode";
    /**
     * Soundbar mode feature enabled.
     */
    public static final int SOUNDBAR_MODE_ENABLED = 1;
    /**
     * Soundbar mode feature disabled.
     */
    public static final int SOUNDBAR_MODE_DISABLED = 0;

   /**
     * Set the status of Soundbar mode feature.
     *
     * <p>This allows to enable/disable Soundbar mode on the playback device.
     * The setting's effect will be available on devices where the hardware supports this feature.
     * If enabled, an audio system local device will be allocated and try to establish an ARC
     * connection with the TV. If disabled, the ARC connection will be terminated and the audio
     * system local device will be removed from the network.
     */
    public void setSoundbarMode(@SoundbarMode int value) {
    }

    /**
     * Get the current status of Soundbar mode feature.
     *
     * <p>Reflects whether Soundbar mode is currently enabled on the playback device.
     * If enabled, an audio system local device will be allocated and try to establish an ARC
     * connection with the TV. If disabled, the ARC connection will be terminated and the audio
     * system local device will be removed from the network.
     */
    public int getSoundbarMode() {}

التنفيذ من قِبل المصنّع الأصلي للجهاز

لإتاحة ميزة مكبّر الصوت العمودي الديناميكي، على المصنّعين الأصليين للأجهزة التأكّد من أنّ الجهاز التي تدعمها. على المصنّعين الأصليين للأجهزة ضبط الجهاز تنفيذ واجهة مستخدم النظام لتوفير الواجهة المطلوبة البيانات التي أدخلها المستخدم.

تنفيذ الجهاز

لإتاحة ميزة مكبّر الصوت العمودي على الجهاز:

  1. انتقِل إلى جهاز التشغيل الذي يعمل بنظام التشغيل Android 14.
  2. أدخِل منفذ HDMI ARC في برنامج التشغيل.

  3. ترك قيم RRO config_cecSoundbarModeEnabled_default وconfig_cecSoundbarModeDisabled_default لم يتغير في config.xml لكي تظل الميزة معطلة بشكل افتراضي.

  4. يُرجى التأكّد من أنّ الجهاز مضمَّن مكبّرات الصوت المتصلة لتشغيل الصوت عليها وتعديل إعدادات سياسة الصوت:

  5. ضبط خاصية النظام persist.sys.hdmi.property_arc_support على true، للإشارة إلى توفّر تقنية "وقت تشغيل التطبيقات في Chrome".

  6. اعرض الإعدادات لتفعيل وضع مكبّر الصوت العمودي في واجهة مستخدم النظام.

لتصحيح الأخطاء، استخدِم الأمر adb التالي لتفعيل ميزة مكبّر الصوت العمودي أو إيقاف (1 للتفعيل و0 للإيقاف):

adb shell cmd hdmi_control cec_setting set soundbar_mode <1/0>

تنفيذ SysUI

يصف هذا القسم تدفقًا موصى به وهميًا لواجهة المستخدم لتشغيل DSM وإيقافه. يندرج إعداد إخراج الصوت ضمن إعدادات العرض قائمة الصوت، كما هو موضّح في الشكل 1:

dsm_audio_output

الشكل 1. إعداد إخراج الصوت ضمن شاشة العرض قائمة الصوت

لكي يعمل DSM، يجب تفعيل الإعداد تفعيل HDMI-CEC. تشير رسالة الأشكال البيانية لا يمكن تفعيل إعداد ARC إلا في حال تفعيل HDMI-CEC. إعداد ARC يصبح باللون الرمادي ويتم إيقافه إذا تم إيقاف HDMI-CEC كما هو موضح في الشكل 2. في جلسة المعمل، اتّباع مسار واجهة المستخدم، عندما يوقف المستخدم إعداد تفعيل HDMI-CEC في جهاز الشاشة قائمة الصوت واختيار مكبّر الصوت المنزلي، وهو إعداد وقت تشغيل التطبيقات في Chrome معطل. يمكن للمستخدم تفعيل إعداد تشغيل الصوت على التلفزيون من خلال تفعيل تفعيل HDMI-CEC

dsm_ui_disable_arc

الشكل 2. واجهة مستخدم لخيار "وقت تشغيل التطبيقات في Chrome" غير المفعَّل

عند تفعيل إعداد HDMI-CEC، يمكن للمستخدم استخدام إعداد ARC ضمن إخراج الصوت لتشغيل DSM وإيقافها. لتشغيل DSM، يتبع المستخدم واجهة المستخدم التدفق في الشكل 3. في مسار واجهة المستخدم التالي، لتفعيل وضع مكبّر الصوت العمودي، يمكن للمستخدِم اختيار مكبّر الصوت المنزلي واختيار إعداد وقت تشغيل التطبيقات في Chrome وتأكيده لتشغيل إيقاف DSM، يوقف المستخدم إعداد ARC.

dsm_ui_enable_arc

الشكل 3. واجهة مستخدم لتفعيل DSM.

التحقُّق

يمكن للمصنّعين الأصليين للأجهزة إجراء اختبار صوتي للتأكد من أن مكبرات الصوت في جهاز التشغيل تشغيل الصوت الصادر من التلفزيون أو من الأجهزة الأخرى المتصلة به اللوحة.

التحقّق من الصحة يدويًا

استخدِم السيناريوهات التالية للتحقّق يدويًا من السلوك المتوقّع:

  • يكون خيار ARC مفعَّلاً:
    • يكتم صوت التلفزيون نفسه.
    • يتم توجيه صوت التلفزيون إلى مكبّرات صوت الجهاز.
  • يكون خيار ARC غير مفعَّل:
    • يتوقف التلفزيون عن توجيه الصوت إلى الجهاز.
    • يبدأ التلفزيون تشغيل الصوت.
  • يتم تفعيل إعداد ARC واتصال الجهاز بشبكة غير ARC المنفذ إلى التلفزيون:
    • لا يشغّل الجهاز صوت التلفزيون.
  • تم تفعيل إعداد ARC ويستخدم العنوان المنطقي 5 من قِبل مستخدم آخر الجهاز قبل ربطه:
    • يعمل الجهاز كجهاز تشغيل فقط، وليس كمكبّر صوت عمودي.
  • تم تفعيل إعداد "وقت تشغيل التطبيقات في Chrome"، وكان العنوان المنطقي 5 قيد الاستخدام بواسطة الجهاز هناك نظام صوتي آخر متصل بالشبكة:
    • ولم يحدث أي تغيير في سلوك مكبّر الصوت العمودي في الجهاز.
  • تم تفعيل إعداد ARC، ويستخدم الجهاز العنوان المنطقي 5 بمنفذ غير ARC، وسيتم توصيل نظام صوتي آخر منفذ ARC:
    • لم يتم إنشاء اتصال تقنية "وقت تشغيل التطبيقات في Chrome" مع التلفزيون للصوت الثاني. لأنه يستخدم عنوانًا منطقيًا غير مسجَّل.
  • عند تفعيل إعداد ARC، وتوصيل الجهاز بمصدر للطاقة:
    • يتّبع الجهاز السلوك العادي كما هو الحال عند تفعيل الإعداد.

التحقّق من صحة CTS

CtsHdmiCecHostTestCases يجب اجتياز الاختبار عند إيقاف إعداد مكبّر الصوت العمودي. HdmiCecSoundbarModeTest.java اختبار في مجموعة اختبار CtsHdmiCecHostTestCases، لاختبار وظائف DSM.

على الرغم من أنّه ليس من متطلبات الشهادة، يمكنك تشغيل CtsHdmiCecHostTestCases مع تم تفعيل إعداد مكبّر الصوت العمودي للتحقّق من صحة التنفيذ.

يُرجى الاطّلاع على اختبار CEC CTS لأجهزة Android TV. لتشغيل اختبارات CTS لنظام التشغيل Android لـ HDMI CEC.