لا تتوافق ميزة Google Cast للأجهزة الصوتية إلا مع تشغيل الصوت. يشرح هذا الدليل كيفية تحسين تطبيقات البث لأجهزة الصوت فقط والاستفادة من المتطلبات المنخفضة في ما يتعلق باستخدام الذاكرة ووحدة المعالجة المركزية (CPU) ومعدل نقل البيانات للشبكة.
يجب مراعاة ما يلي عند اختيار التطبيق الذي يتوافق مع Google Cast للصوت:
- لا تعرض ميزة Google Cast للأجهزة الصوتية فيديوهات أو رسومات. تتضمّن العديد من الأجهزة الصوتية طريقة لعرض البيانات الوصفية، مثل حالة التشغيل (التشغيل أو الإيقاف المؤقت) والتقدّم. يجب ألا يعرض تطبيقك معلومات المستخدم المهمة هذه على المستلِم فقط، ويجب أن تظهر المعلومات المهمة ومعظم واجهة المستخدم على المرسِل.
- لتشغيل تطبيقات مستقبِل الويب بشكل صحيح، لا يزال على Google Cast للأجهزة الصوتية عرض الرسومات على الرغم من عدم عرضها. وبما أنّ الأجهزة قد لا تتوافق مع عمليات الرسومات المسرّعة للأجهزة، يجب أن تتجنّب تطبيقات المُستلِم استخدام العمليات التي تستهلك قدرًا مكثفًا من الرسومات، مثل تدرجات الألوان والتدوير ودمج ألفا وإعادة رسم عناصر كبيرة، مثل أشرطة التقدم أكثر من مرة في الثانية.
- لا تتوافق ميزة Google Cast للأجهزة الصوتية سوى مع المحتوى المحمي بموجب Widevine لإدارة الحقوق الرقمية (DRM).
- بالنسبة إلى معظم أجهزة Google Cast للأجهزة الصوتية، يتحكم تطبيق المُرسِل في نطاق الصوت الكامل للجهاز (مكبّر الصوت مثلاً)، وليس فقط مستوى صوت مصدر الصوت إلى التلفزيون، كما هو الحال مع جهاز Chromecast.
- بالإضافة إلى التحكم في التشغيل باستخدام جهاز المُرسِل (هاتف مثلاً)، قد يحتاج التطبيق إلى توفير إمكانية التحكّم في التشغيل باستخدام وحدات التحكّم الخاصة بالجهاز، مثل وحدة التحكّم عن بُعد أو أزرار الجهاز أو تطبيق خارجي.
- يمكن أن يتيح جهاز Google Cast للصوت عرض البيانات الوصفية للمحتوى مع شاشة LCD صغيرة أو منفذ HDMI (لأشرطة الصوت أو أجهزة استقبال الفيديو الصوتية) أو تطبيق خارجي عن بُعد بناءً على واجهة المستخدم المحددة للجهاز.
تطوير
تتمثل الخطوة الأولى لتطوير تطبيق "إرسال" لدعم Google Cast للصوت في تطوير تطبيق Cast للفيديو الصوتي، والتأكد من تشغيله على Chromecast. يفترض هذا المستند أنك طوّرت هذا التطبيق واختبرته.
قد يتوافق التطبيق مع كل من أجهزة الصوت والفيديو فقط. وهي بحاجة إلى معرفة عندما يتم إرسالها إلى الأخرى واتخاذ إجراءات لضمان أفضل تجربة للمستخدم وفقًا للسيناريو المحدّد.
على سبيل المثال، يجب أن تفعّل تطبيقات الفيديو والصوت المزدوجة (مثل تطبيقات تشغيل الملفات المحلية/NAS) البث على الأجهزة الصوتية فقط لإتاحة تشغيل الملفات الصوتية، ولكن يجب ألا يسمح التطبيق للمستخدم بإرسال ملفات الفيديو إلى الجهاز السماعي فقط. يمكن للتطبيق استخدام واجهات برمجة تطبيقات إمكانيات الجهاز للمُرسِلين الموضّحة أدناه لتحديد المحتوى المناسب للجهاز.
للتوافق مع Google Cast للصوت، يجب أن يُنفِّذ تطبيقك ما يلي:
التوافق مع الصوت فقط: بث الموسيقى والملفات الصوتية والراديو وما إلى ذلك. ويجب ألا تكون الوسائط التي يتم بثها إلى تطبيق "استقبال الويب" عبارة عن بث فيديو. تجنَّب أيضًا بث الرسومات والصور لتحسين وقت تشغيل التطبيق واستخدام الذاكرة. يمكنك الاطّلاع على إرشادات استخدام الذاكرة أدناه.
يمكنك التشغيل كما هو متوقع على جهاز بث لجهاز الصوت بالإضافة إلى جهاز Chromecast عادي.
إمكانات الجهاز
يمكن أن يعرف تطبيقك ما إذا كان يعمل على جهاز الصوت فقط بموجب واجهات برمجة التطبيقات الخاصة بإمكانيات الجهاز، وهي متوفّرة من الجهاز نفسه أو من خلال واجهات برمجة تطبيقات المُرسِل أو المُستلِم.
عنوان HTTP للجهاز
يصف عنوان HTTP CAST-DEVICE-CAPABILITIES
المقدَّم من جهاز البث أثناء تشغيل التطبيق إمكانيات الجهاز. يرسل الجهاز طلبًا
مع هذا العنوان إلى الخادم الذي يستضيف تطبيق Web Render. ويوضح عنوان الجهاز السماعي فقط إمكانات الجهاز باستخدام
CAST-DEVICE-CAPABILITIES: {"display_supported":false}
.
وعند تلقّي الخادم الطلب من الجهاز، يمكنك استخدام المعلومات الواردة في هذا العنوان لإعادة توجيه الطلب إلى تطبيق "استقبال الويب" الذي تم تحسينه للأجهزة الصوتية.
واجهة برمجة تطبيقات استقبال الويب
يمكنك الحصول على الكائن نفسه لإمكانات الجهاز من خلال الاتصال بـ CastReceiverManager.getDeviceCapabilities()
عند تحميل تطبيق مستلم الويب.
راجِع إمكانات الجهاز للحصول على المزيد من المعلومات.
واجهات برمجة تطبيقات المُرسِل
تحتوي كل واجهة من واجهات برمجة تطبيقات مُرسِل الإرسال على معلومات إمكانات الجهاز. وتتيح هذه الإعدادات لتطبيق المُرسِل تحديد نوع الوسائط التي تريد إرسالها إلى المستلِم. إذا كان تطبيقك يتيح كلاً من الصوت والفيديو، يمكن أن يتجنّب إرسال محتوى الفيديو إلى الأجهزة الصوتية فقط. يمكن لتطبيقك أيضًا التحكم في مستوى الصوت باستخدام الطريقة الأكثر ملاءمةً للجهاز، كما هو موضّح في قائمة التحقق من التصميم. راجِع واجهات برمجة التطبيقات لإمكانيات الجهاز التالية للمُرسِلين:
- Android: CastDevice.hasCapability
- iOS: deviceCapability
- Chrome: chrome.cast.Capability
إرشادات استخدام الذاكرة
يجب أن تدير تطبيقات مستقبِل الويب التي تعمل على الأجهزة الصوتية استخدام الذاكرة كما يلي:
- تجنّب تنزيل أي مواد عرض صور أو رسومات أو استخدامها لتقليل بصمتك الذاكرة وتقصير الوقت حتى يبدأ التشغيل.
- عند استخدام إضافات مصادر الوسائط (MSE)، على التطبيقات تقييد المخزن المؤقت للبث 2 ميغابايت. إذا كان يتم استخدام مكتبة مشغّل الوسائط (MPL)، يتم تحديد حجم ذاكرة التخزين المؤقت للتطبيق's من خلال MPL.
- عند استخدام HTMLMediaElement، يعرّف متصفّح Chrome حجم التطبيق للمخزن المؤقت للتطبيقات بنسبة 39%، وذلك بناءً على معدل البث. يمكنك تقييد معدل نقل البيانات الصوتي إلى 2 ميغابت في الثانية، وهو ما يتوافق مع جميع برامج الترميز الموضَّحة في الوسائط المتوافقة (بحد أقصى 48 كيلوهرتز/16 بت).
التحكم في مستوى الصوت
بالنسبة إلى معظم أجهزة Google Cast للأجهزة الصوتية، يتحكّم تطبيق المُرسِل في نطاق مستوى الصوت الخاص بجهازك، وليس فقط مستوى صوت مصدر المصدر الصوتي، كما هو الحال مع جهاز Chromecast. وهذا يعني أن زيادات تغيير مستوى الصوت يجب أن تكون أصغر حجمًا للتطبيقات الصوتية فقط. يُرجى الاطّلاع على المستندات التالية للحصول على إرشادات حول التحكّم في مستوى الصوت في تطبيقك:
- عناصر التحكّم في حجم المُرسِل في قائمة التحقق من التصميم
- حجم مرسِل Android
- حجم مُرسِل نظام التشغيل iOS
- حجم مُرسِل الويب
التحكّم بالجهاز
قد تتضمّن أجهزة Google Cast للأجهزة الصوتية عناصر تحكّم في التشغيل خاصة بها (مثل الأزرار وأجهزة التحكّم عن بُعد). تستخدم هذه الرسائل رسائل تشغيل الوسائط المحدّدة لمساحة الاسم urn:x-cast:com.google.cast.media
، كما هو موضّح في رسائل تشغيل الوسائط، من أجل التحكّم في التشغيل
في تطبيق جهاز الاستقبال. يجب أن يتوافق تطبيق المُستلِم مع رسائل تشغيل الوسائط هذه لإتاحة عناصر التحكّم في تشغيل الجهاز.
ويجب أيضًا أن يتيح تطبيق "المرسِل" إمكانية استخدام الرسائل من المستلِم إلى المُرسِل، بحيث إذا غيّر المستخدم حالة الوسائط باستخدام عناصر التحكّم في الجهاز، يمكن أن يتلقّى تطبيق المُرسِل رسالة حالة من المُستلِم وتعديل واجهة المستخدم وفقًا لذلك.
شاشة عرض الجهاز
قد يتوفّر جهاز Google Cast للصوت مع شاشة LCD على الجهاز أو تطبيق تحكّم خاص بالجهاز يعرض البيانات الوصفية للوسائط. ويجب أن يوفر تطبيق المُستلِم هذه البيانات الوصفية لكل المقاطع الصوتية والتأكد من مزامنتها مع المحتوى الذي يتم تشغيله حاليًا لضمان ظهور البيانات الوصفية بشكل مناسب على الشاشة. إذا كان التطبيق يستخدم البيانات الوصفية المخصصة، يجب أن يوفر أيضًا البيانات الوصفية القياسية للصوت (اسم المقطع الصوتي واسم الفنان وعنوان الألبوم وغير ذلك) كما هو موضّح لكل نظام أساسي أدناه.
ويحصل المُستلِم على البيانات الوصفية من المُرسِل عند تحميل الوسائط. في تطبيق المُرسِل، باستخدام أمر تحميل الوسائط على جهاز الاستقبال، عليك تحديد الحقول الموضّحة أدناه حتى يتم عرض البيانات الوصفية على جهاز Google Cast لجهاز الصوت. استخدِم واجهات برمجة التطبيقات التالية:
نظام التشغيل Android
MediaMetadata
معMEDIA_TYPE_MUSIC_TRACK
و:نظام التشغيل iOS
GCKMediaMetadata
باستخدامGCKMediaMetadataType
GCKMediaMetadataTypeMusicTrack
و:متصفّح Chrome
MediaInfo
معMusicTrackMediaMetadata
و:
إذا كان تطبيق "البث" يدير قائمة انتظار الوسائط على جهاز الاستقبال أو على السحابة الإلكترونية،
يجب أن يستقبل
جهاز استقبال الويب أي تعديلات على حالة الوسائط باستخدام مساحة الاسم
urn:x-cast:com.google.cast.media
حتى تتم مزامنة جميع المُرسِلين.
تسجيل
يجب تسجيل جهاز Google Cast لاختبار الصوت وتسجيل تطبيقك لتوافق مع Google Cast للأجهزة الصوتية باستخدام وحدة تحكم مطوّري البرامج لحزمة تطوير البرامج (SDK) في Google Cast.
- للمزيد من المعلومات حول تسجيل الأجهزة، يمكنك الاطّلاع على الأجهزة.
- يجب وضع علامة في مربّع الاختيار يتوافق مع البث على الأجهزة الصوتية فقط عند تسجيل التطبيق للسماح لتطبيقك باكتشاف Google Cast للأجهزة الصوتية. يُرجى الاطّلاع على تسجيل طلبك.
بالنسبة إلى التطبيقات التي تم إلغاء نشرها، مثل التطبيقات المستخدمة للاختبار، يجب أيضًا تحديد خيار دعم الأجهزة الصوتية فقط حتى يتمكن التطبيق من اكتشاف الأجهزة الصوتية فقط.
Google Cast for Audio 2.0
الإصدار 2.0 من Google Cast for Audio (GC4A) هو النظام الأساسي الجديد للبث الصوتي من Cast الذي تم تصميمه لاستهداف الأجهزة ذات الذاكرة المنخفضة، لتوسيع المنظومة المتكاملة للأجهزة التي يمكنها بث المحتوى.
من المهم أن يختبر مطوّرو تطبيقات الصوت تطبيقاتهم على GC4A 2.0. يمكنك اختبار تطبيق البث على GC4A 2.0 على مكبّر صوت Bose للإنتاج (على سبيل المثال، Buse Smart مكبّر الصوت 500).
يُرجى التواصل مع gc4a-support-external@google.com إذا كنت بحاجة إلى مساعدة في الإعداد للاختبار، أو يتعذّر عليك استخدام مكبّر صوت Bose. إذا كنت تريد تصحيح أخطاء تطبيقك، تقترح Google استخدام أداة تسجيل تصحيح الأخطاء.