أجهزة الصوت

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

على التطبيقات التي تتوافق مع Google Cast للمحتوى الصوتي مراعاة ما يلي: الاعتبار:

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

تطوير

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

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

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

للتوافق مع Google Cast للوسائط، يجب أن يتّبع تطبيقك ما يلي:

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

  • تعمل على النحو المتوقع على جهاز بث على جهاز سماعي وكذلك على جهاز Chromecast عادي.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

عناصر التحكّم في الأجهزة

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

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

عرض الجهاز

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

يحصل المُستلِم على البيانات الوصفية من المُرسِل عند تحميل الوسائط. ضِمن إلى تطبيق المرسل، فمع أمر تحميل الوسائط على جهاز الاستقبال، يجب عليك الحقول الموضحة أدناه لكي يتم عرض البيانات الوصفية Google 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 هو الجيل التالي من أنظمة إرسال الصوت التي تعمل بتكنولوجيا Google Cast مصمم لاستهداف الأجهزة ذات الذاكرة المنخفضة، ولتوسيع المنظومة المتكاملة للأجهزة التي من بث المحتوى الخاص بك. بما أنّ GC4A 2.0 تستهدف الأنظمة الأساسية الصوتية، فإنّ واجهة برمجة تطبيقات الويب مجموعة لتتوافق مع الأجهزة غير القابلة للعرض. سيتم طرح الإصدار GC4A 2.0 في حزمة ومكبّرات الصوت الحالية التي تتيح البث

الاختبار وتصحيح الأخطاء

بما أنّه سيتم نقل جميع مكبّرات الصوت المتوافقة إلى الإصدار GC4A 2.0، من المهم مطورو التطبيقات الصوتية يختبرون تطبيقاتهم على الإصدار GC4A 2.0 يمكنك اختبار تطبيق Cast على GC4A 2.0 على مكبرات صوت Bose Wi-Fi للإنتاج، وJBL Charge 5 Wi-Fi، وJBL Authentics وCambridge Audio وTuful Motiv Home وLG 2024 Soundbars.

لا يتوافق الإصدار GC4A 2.0 مع "برنامج تصحيح الأخطاء عن بُعد في Chrome". إذا كنت تريد تصحيح أخطاء تنصحك Google باستخدام Cast Debugger (سجل تصحيح الأخطاء للإرسال).

يُنصح باختبار جميع ميزات التطبيق على الإصدار GC4A 2.0. تأكد من تضمين اختبار تشغيل جميع أنواع الوسائط (ملفات البودكاست والبث وغير ذلك) وإيقافها مؤقتًا وترجيعها تخطي قوائم التشغيل وتغييرها وإيقاف البث وإعادة ربطها

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

يتوافق الإصدار GC4A 2.0 مع واجهات برمجة التطبيقات التالية:

  • HTML
  • JavaScript ECMA 6
  • DOMParser
  • XMLSerializer
  • الوثيقة والفئات الفرعية
  • DocumentFragment
  • HTMLMediaElement & HTMLAudioElement
  • HTMLVideoElement (يمكن تشغيل محتوى الصوت فقط)
  • HTMLScriptElement
  • HTMLBaseElement
  • HTMLTemplateElement
  • العناصر المخصصة
  • نموذج Shadow DOM
  • وحدات النص البرمجي / غير متزامن / مؤجل
  • الجلب / XHR
  • WebSocket
  • MessagePort
  • بسكويت
  • إضافات مصدر الوسائط (MSE)
  • EME (إضافات الوسائط المشفرة)
  • التخزين المحلي / الجلسة

لا يتوافق الإصدار GC4A 2.0 مع ما يلي:

  • استيراد الوحدات الديناميكية (ستتم إضافتها في 2024)
  • CSS
  • IFrame
  • TextTracks

جهة اتصال

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