أجهزة الصوت

لا تتيح Google Cast للأجهزة الصوتية إلا تشغيل الصوت. يشرح هذا الدليل كيفية تحسين تطبيقات Cast للأجهزة التي تعمل بالصوت فقط والاستفادة من انخفاض الطلب على استخدام الذاكرة ووحدة المعالجة المركزية (CPU) ومعدل نقل البيانات للشبكة.

يجب أن يأخذ التطبيق الذي يتوافق مع Google Cast for Audio ما يلي في الاعتبار:

  • لا تعرض تكنولوجيا Google Cast للأجهزة الصوتية فيديوهات أو رسومات. ومع ذلك، يتم عرض البيانات الوصفية في العديد من الأجهزة الصوتية، مثل حالة التشغيل (قيد التشغيل أو المتوقفة مؤقتًا) ومستوى التقدّم. يجب ألا يعرض تطبيقك معلومات المستخدم المهمة هذه على المستلِم فقط، أي أنّ المعلومات المهمة ومعظم واجهة المستخدم يجب أن تظهر على المُرسِل.
  • لتشغيل تطبيقات جهاز استقبال الويب بشكل صحيح، يجب أن تعرض تقنية Google Cast للأجهزة الصوتية رسومات حتى لو لم يتم عرضها. وبما أنّ الأجهزة قد لا تتيح تشغيل الرسومات التي تتم تسريعها في الأجهزة، يجب أن تتجنّب تطبيقات أجهزة الاستقبال استخدام العمليات التي تتضمّن رسومات مكثفة، مثل تدرّج الألوان والتدوير ودمج ألفا، وإعادة رسم العناصر الكبيرة، مثل أشرطة التقدم، أكثر من مرة في الثانية.
  • تتوافق تكنولوجيا Google Cast مع الأجهزة الصوتية مع نظام ويندفين لإدارة الحقوق الرقمية (DRM) فقط.
  • في معظم أجهزة Google Cast الصوتية، يتحكّم تطبيق المرسِل في النطاق الكامل لمستوى الصوت (مكبّر الصوت)، وليس فقط في مستوى صوت إدخال مصدر الصوت إلى التلفزيون، كما هو الحال مع جهاز Chromecast.
  • بالإضافة إلى التحكّم في التشغيل باستخدام جهاز المرسِل (مثل الهاتف)، قد يجب على التطبيق توفير إمكانية التحكّم في التشغيل باستخدام وحدات التحكم الخاصة بالجهاز مثل وحدة التحكّم عن بُعد أو الأزرار على الجهاز أو تطبيق خارجي عن بُعد.
  • وقد يتيح Google Cast لجهاز سماعي عرض البيانات الوصفية للمحتوى من خلال شاشة LCD صغيرة أو إخراج HDMI (لمكبّرات الصوت العمودية أو أجهزة استقبال الصوت والفيديو) أو تطبيق خارجي عن بُعد، وهذا يتوقف على واجهة المستخدم المحددة للجهاز.

تطوير

تتمثل الخطوة الأولى في تطوير تطبيق Cast لدعم Google Cast في الصوت في تطوير تطبيق Cast لبثّ الصوت والفيديو، والتأكد من تشغيله على جهاز Chromecast. تفترض هذه الوثيقة أنك طورت هذا التطبيق واختبرته.

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

على سبيل المثال، من المفترض أن توفّر تطبيقات الصوت والفيديو المزدوجة (مثل تطبيقات تشغيل الملفات المحلية/NAS) إمكانية البث إلى الأجهزة التي تعمل بالصوت فقط لإتاحة تشغيل الملفات الصوتية، ولكن يجب ألا يسمح التطبيق للمستخدم بإرسال ملفات الفيديو إلى جهاز الصوت فقط. يمكن للتطبيق استخدام واجهات برمجة التطبيقات لإمكانيات الجهاز للمُرسِلين الموضّحة أدناه لتحديد المحتوى المناسب للجهاز.

للتوافق مع Google Cast للصوت، يجب أن ينفذ تطبيقك ما يلي:

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

  • يمكنك تشغيل البث كما هو متوقع على جهاز البث لجهاز الصوت بالإضافة إلى جهاز Chromecast العادي.

إمكانات الجهاز

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

عنوان HTTP للجهاز

يصف عنوان HTTP يتضمّن العنصر CAST-DEVICE-CAPABILITIES الذي يوفّره جهاز البث أثناء تشغيل التطبيق إمكانيات الجهاز. يرسل الجهاز طلبًا يتضمّن هذا العنوان إلى الخادم الذي يستضيف تطبيق "جهاز استقبال الويب". ويصف عنوان الجهاز الذي يعمل بالصوت فقط إمكانيات الجهاز مع CAST-DEVICE-CAPABILITIES: {"display_supported":false}.

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

واجهة برمجة تطبيقات استقبال الويب

يمكنك الحصول على عنصر إمكانيات الجهاز نفسه عن طريق استدعاء CastReceiverManager.getDeviceCapabilities() عندما يتم تحميل تطبيق Web اهتماماتك.

راجع إمكانات الجهاز للحصول على مزيد من المعلومات.

واجهات برمجة تطبيقات المُرسِل

وتحتوي كل واجهة من واجهات برمجة التطبيقات لمرسلي البث على معلومات عن إمكانات الجهاز أيضًا. يتيح ذلك لتطبيق المرسل تحديد نوع الوسائط التي يجب إرسالها إلى المُستلِم. إذا كان تطبيقك يتيح استخدام الصوت والفيديو معًا، يمكنك تجنُّب إرسال محتوى الفيديو إلى الأجهزة الصوتية فقط. بالإضافة إلى ذلك، يمكن لتطبيقك التحكّم في مستوى الصوت باستخدام الطريقة الأكثر ملاءمة للجهاز، كما هو موضّح في قائمة التحقّق من التصميم. يُرجى الاطّلاع على واجهات برمجة التطبيقات التالية لإمكانيات الجهاز الخاصة بالمُرسِلين:

إرشادات استخدام الذاكرة

يجب أن تدير تطبيقات أجهزة استقبال الويب التي تعمل على الأجهزة الصوتية استخدام الذاكرة على النحو التالي:

  • تجنَّب تنزيل أي أصول للصور أو الرسومات أو استخدامها، للتقليل من المساحة المتبقية للذاكرة وتقصير الوقت اللازم لبدء التشغيل.
  • عند استخدام إضافات مصدر الوسائط (MSE)، يجب أن تحد التطبيقات من حجم المخزن المؤقت للبث إلى 2 ميغابايت. في حال استخدام مكتبة مشغّل الوسائط (MPL)، يتم تحديد حجم المخزن المؤقت للبث المباشر للتطبيق من قبل MPL.
  • عند استخدام HTMLMediaElement، يحدد Chrome حجم المخزن المؤقت لمصدر البيانات في التطبيق بناءً على معدل البث. يجب ألا يزيد معدل نقل بيانات الصوت عن 2 ميغابت في الثانية، وهذا يتوافق مع جميع برامج الترميز الموضحة في الوسائط المتوافقة (حتى 48 كيلوهرتز/16 بت).

التحكم في مستوى الصوت

في معظم أجهزة Google Cast for Audio، يتحكّم تطبيق المرسِل في النطاق الكامل لمستوى الصوت، وليس فقط في مستوى صوت إدخال مصدر الصوت، كما هو الحال مع جهاز Chromecast. وهذا يعني أن زيادات تغيير مستوى الصوت يجب أن تكون أصغر في التطبيقات الصوتية فقط. ويمكنك الاطّلاع على المستندات التالية للحصول على إرشادات حول توفير التحكّم في مستوى الصوت في تطبيقك:

التحكّم بالجهاز

قد تتضمن Google Cast للأجهزة الصوتية عناصر تحكّم في التشغيل خاصة بها (مثل الأزرار وأجهزة التحكّم عن بُعد). تستخدم هذه الرموز رسائل تشغيل الوسائط المحدّدة لمساحة الاسم urn:x-cast:com.google.cast.media، كما هو موضّح في رسائل تشغيل الوسائط، وذلك للتحكّم في التشغيل في تطبيق جهاز الاستقبال. يجب أن يتوافق تطبيق جهاز الاستقبال مع رسائل تشغيل الوسائط هذه لإتاحة عناصر التحكم في التشغيل في الجهاز.

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

عرض الجهاز

قد يتضمّن جهاز Google Cast for Audio شاشة LCD على الجهاز أو تطبيق تحكّم خاص بالجهاز يعرض البيانات الوصفية للوسائط. يجب أن يوفر تطبيق جهاز الاستقبال هذه البيانات الوصفية لكل المقاطع الصوتية والتأكد من أنها متزامنة مع المحتوى الذي يتم تشغيله حاليًا لضمان عرض البيانات الوصفية بالشكل المناسب على الشاشة. إذا كان التطبيق يستخدم بيانات وصفية مخصّصة، يجب أيضًا توفير البيانات الوصفية القياسية للصوت (اسم المقطع الصوتي واسم الفنان وعنوان الألبوم وما إلى ذلك) كما هو موضّح لكل نظام أساسي أدناه.

يحصل المُستلِم على البيانات الوصفية من المُرسِل عند تحميل الوسائط. في تطبيق المرسل، من خلال أمر تحميل الوسائط على جهاز الاستقبال، عليك تحديد الحقول الموضحة أدناه حتى يتم عرض البيانات الوصفية على Google Cast for Audio. استخدِم واجهات برمجة التطبيقات التالية:

إذا كان تطبيق Cast يدير قائمة انتظار وسائط على جهاز الاستقبال أو على السحابة الإلكترونية، على جهاز استقبال الويب بث أي تحديثات لحالة الوسائط باستخدام مساحة الاسم urn:x-cast:com.google.cast.media حتى تتم مزامنة جميع المرسِلين.

تسجيل

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

  • راجع الأجهزة للحصول على مزيد من المعلومات حول تسجيل الأجهزة.
  • يجب وضع علامة في مربّع الاختيار دعم البث على الأجهزة الصوتية فقط عند تسجيل تطبيقك للسماح لتطبيقك باكتشاف Google Cast للأجهزة الصوتية. يُرجى الاطّلاع على تسجيل طلبك.

بالنسبة إلى التطبيقات التي تم إلغاء نشرها، مثل تلك المستخدَمة للاختبار، يجب أيضًا تحديد خيار إتاحة الأجهزة الصوتية فقط حتى يتمكن التطبيق من اكتشاف الأجهزة الصوتية فقط.

Google Cast for Audio 2.0

إنّ Google Cast for Audio (GC4A) 2.0 هو الجيل التالي من نظام بث الصوت البثّ المصمَّم لاستهداف الأجهزة ذات الذاكرة المنخفضة لتوسيع المنظومة المتكاملة للأجهزة التي يمكنها بث المحتوى.

من المهم أن يختبر مطوّرو التطبيقات الصوتية تطبيقاتهم على GC4A 2.0. يمكنك اختبار تطبيق Google Cast على GC4A 2.0 على مكبّر صوت Bose للإنتاج (على سبيل المثال، Bose Smart Speaker 500).

يُرجى التواصل مع gc4a-support-external@google.com إذا كنت بحاجة إلى مساعدة في الإعداد للاختبار أو تعذّر عليك استخدام مكبّر صوت من Bose. إذا كنت تريد تصحيح أخطاء تطبيقك، تنصحك Google باستخدام مسجِّل تصحيح أخطاء البث.