أداة Command and Control (CaC)

تُعد أداة Command and Control (CaC) مرسل ويب فعال لمطوّري البرامج لاختبار تطبيق مستقبل الويب وتصحيح أخطائه.

يمكن لمطوّري البرامج استخدام أداة CaC من أجل:

  • شغّل تطبيق مستقبل الويب على جهاز يعمل بتكنولوجيا Google Cast وأرسل طلب تحميل لبدء تشغيل الوسائط.
  • يمكنك محاكاة الطلبات الصوتية التي يرسلها "مساعد Google" إلى مستقبِل الويب.
  • يمكنك تسجيل السجلات من Cast Debug Loger والتحكُّم في طبقة تصحيح أخطاء جهاز استقبال الويب.

تشغيل تطبيق مستلم الويب

هناك طريقتان لتشغيل جهاز استقبال الويب باستخدام أداة CaC:

  1. لبدء جلسة بث جديدة:

    1. افتح أداة CaC، وأدخل معرّف تطبيق مستلم الويب، ثم انقر على الزر تعيين معرّف التطبيق.
    2. انقر على زر الإرسال وحدد جهازًا لتشغيل مستلم الويب على جهاز يعمل بتكنولوجيا Google Cast عن بُعد.

  2. للانضمام إلى جلسة بث حالية:

    1. احصل على معرّف جلسة البث الذي يعمل حاليًا باستخدام الرموز التالية:

      من جانب مستقبِل الويب، استخدِم الطريقة التالية للحصول على معرِّف الجلسة في وحدة تحكُّم برنامج تصحيح الأخطاء عن بُعد من Chrome:

      cast.framework.CastReceiverContext.getInstance().getApplicationData().sessionId;
      

      أو للحصول على معرِّف الجلسة من مُرسِل ويب متصل، استخدم الطريقة التالية:

      cast.framework.CastContext.getInstance().getCurrentSession().getSessionId();
      
    2. أدخِل رقم تعريف الجلسة في أداة CaC وانقر على الزر استئناف.

عندما تكون أداة CaC متصلة بتطبيق "جهاز استقبال الويب"، يظهر زر الإرسال مع شكل إطار ممتلئ. يتم أيضًا عرض معرّف تطبيق مستلم الويب ومعرّف الجلسة في الجزء العلوي من الأداة.

تحميل الوسائط

حمِّل الوسائط من تطبيق المُرسِل أو أداة CAC.

تطبيق المُرسِل

لبدء تشغيل الوسائط على مستقبِل الويب، يُرجى إرسال تطبيق المُرسِل إلى الجهاز نفسه الذي يعمل بتكنولوجيا Google Cast وإرسال طلب التحميل من تطبيق المُرسِل إلى مستقبِل الويب.

أداة CaC

توفّر أداة CaC أيضًا طرقًا متعدّدة لإرسال طلب تحميل إلى تطبيق Web مستقبل البحث:

التحميل بحسب الكيان (إرسال الصوت)

عندما يبدأ المستخدمون تشغيل الوسائط من خلال "مساعد Google"، يستخدم "مساعد Google" رسائل الطلبات والتحكّم لإرسال بيانات اعتماد المستخدم والكيان إلى مستقبِل الويب.

وتحاكي أداة CaC الإرسال الصوتي وترسل طلب تحميل باستخدام credentials وentity.

التحميل بحسب المحتوى

يمكن لأداة CaC أيضًا محاكاة تطبيقك بإرسال طلب تحميل باستخدام Content ID أو Content Url.

عند بدء تشغيل الوسائط، تتلقّى أداة CaC رسائل حالة الوسائط من تطبيق "مستقبل الويب" وتعرضها في علامة التبويب حالة الوسائط.

طلب تحميل مخصص

إذا كنت ترغب في اختبار جهاز الاستقبال باستخدام كائنات Load Request الخاصة بك، فاستخدم حقل طلب تحميل مخصص ضمن علامة التبويب LOAD MEDIA. أولاً، حدد نوع الطلب من أزرار اختيار تحديد نوع الطلب، ثم انسخ والصق كائن JSON الخاص بك.

اختبار الأوامر الصوتية

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

فحص مسجل تصحيح أخطاء الإرسال والتحكم فيه

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

استخدم الأزرار التالية للتحكم في مستلم الويب وسجل الرسائل:

  • رقم تعريف تطبيق مستقبِل الويب
    • محو ذاكرة التخزين المؤقت وإيقاف استقبال الويب - أعد تحميل تطبيق مستقبل الويب وأوقف الإرسال
  • تراكب تصحيح أخطاء جهاز استقبال الويب
    • عرض - تبديل تراكب تصحيح الأخطاء على جهاز استقبال الويب
    • محو - محو رسائل السجل على تراكب تصحيح أخطاء مستلم الويب
  • عناصر التحكم في تسجيل الرسائل
    • إدراج رسالة - إدراج تعليقات أو مقسمات في منطقة السجل
    • تنزيل السجل - حفظ رسائل السجل
    • محو السجل - محو رسائل السجل في منطقة السجل
  • تسجيل الرسائل
    • العلامات المخصصة - انقر على مربع الاختيار لفلترة رسائل السجل

قد تظهر العلامات التالية ضمن العلامات المخصصة. تتم إضافة هذه الأدوات من خلال أداة CaCC لعرض السجلات المهمة أو الرسائل المتعلقة بجلسة تصحيح الأخطاء وتصفيتها:

  • MEDIA - تم إرسال الرسائل بنجاح عبر مساحة اسم الوسائط
  • MEDIA-ERROR - حدث خطأ أثناء الإرسال أو في الرد على الرسائل المرسلة عبر مساحة الاسم للوسائط
  • CAC - تم إرسال الرسائل بنجاح عبر مساحة اسم CAC
  • خطأ CAC - حدث خطأ أثناء الإرسال أو عند الرد على الرسائل المرسلة عبر مساحة اسم CAC
  • تشغيل - السجل الذي يعرض النتيجة عند النقر على الزر جارٍ التشغيل في أداة CaC
  • USER - سجل يعرض الرسالة المخصصة التي أدخلها المستخدم باستخدام الزر إدراج رسالة في أداة CaC

اختبار Cast Connect

لاختبار Cast Connect، نفّذ الخطوات التالية قبل إنشاء جلسة:

  1. أدخل رقم تعريف تطبيق المُستلِم المرتبط بالمستقبل الذي تم تفعيل Cast Connect به وانقر على تعيين رقم تعريف التطبيق.
  2. انقر على الزر إظهار خيارات Android TV.
  3. حدد مربع الاختيار androidReceivedrcompatible. إذا لم يكن المُستلِم يتطلب Launch Credentials لضبط، أو إذا كنت ترغب في اختبار ما يحدث في حالة عدم تعيينه، يمكنك التوقف هنا والمتابعة إلى الخطوة 5.
  4. (اختياري) أدخل Launch Credentials وانقر على الزر تعيين بيانات اعتماد التشغيل لتعيين بيانات اعتماد التشغيل لجلسة الإرسال من Cast.
  5. ابدأ جلسة بث بالنقر على رمز الإرسال في العنوان أو من خلال قائمة الإرسال في متصفح Chrome.

من المفترض أن يتم تشغيل تطبيق Android TV الآن على جهازك.