كتابة تطبيقات المُرسِل لـ CAF DAI SDK

بخلاف عمليات الدمج السابقة بين Chromecast وDAI، تركّز حزمة تطوير البرامج (SDK) لإدراج إعلان ديناميكي (DAI) في CAF بشدة على الحفاظ على المعايير والتوقعات التي وضعتها إطار عمل إرسال المحتوى. ومن هذا المنطلق، ليست هناك أي متطلبات لإجراء تخصيص كبير لتطبيقات المُرسِل لإدارة الاتصالات ثنائية الاتجاه بين إعلانات الوسائط التفاعلية (IMA) وتطبيق المُرسِل. تتم الآن إدارة هذه الاتصالات عبر وظيفة فواصل إعلانات CAF المدمجة، بدلاً من طلب أنظمة رسائل مخصّصة للاتصال بين تطبيق المُرسِل والمُستلِم.

استنادًا إلى المُرسِل، قد لا تزال بحاجة إلى إضافة رمز محدود إلى المُرسِلين لتفعيل دعم الفواصل الإعلانية في "إعلانات CAF" بالكامل، مثل إضافة دعم للإعلانات القابلة للتخطي إلى مُرسِلي الويب.

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

ومع ذلك، لغرض البساطة، ستفترض جميع العينات أن تتبع هذه البنية البسيطة واصطلاح التسمية لكائنات MediaInfo:

معرّف المحتوى معرّف فريد لعنصر الوسائط هذا
contentUrl عنوان URL للبث الاحتياطي المطلوب تحميله في حال تعذّر تنفيذ DAI StreamRequest لأي سبب من الأسباب
streamType بالنسبة إلى أحداث البث المباشر، يجب ضبط هذه القيمة على "مباشر". بالنسبة إلى أحداث البث المباشر بحسب الطلب، يجب ضبط هذه القيمة على "تم التخزين المؤقت".
customData assetKey أحداث البث المباشر فقط: لتحديد البث المباشر المراد تحميله
contentSourceId أحداث البث المباشر بحسب الطلب فقط لتحديد خلاصة الوسائط التي تحتوي على مجموعة البث المطلوبة.
معرّف الفيديو أحداث البث المباشر بحسب الطلب فقط لتحديد مجموعة البث المطلوبة ضمن خلاصة الوسائط المحددة.
ApiKey مفتاح اختياري لواجهة برمجة التطبيقات يمكن طلبه لاسترداد عنوان URL للبث من أداة تطوير البرامج (SDK) لإدراج إعلان ديناميكي لإعلانات الوسائط التفاعلية (IMA).
المرسِل يمكنه التخطّي قيمة منطقية لإعلام المُستلِم بما إذا كان الجهاز المُرسِل قادرًا على عرض زر التخطي، ما يتيح الإعلانات القابلة للتخطي

مثال على بث مباشر:

{
  "media": {
    "contentId": "bbb",
    "contentUrl": "https://storage.googleapis.com/interactive-media-ads/media/bbb.m3u8",
    "streamType": "LIVE",
    "customData": {
      "assetKey": "sN_IYUG8STe1ZzhIIE_ksA",
      "ApiKey": "",
      "senderCanSkip": true
    }
  },
  "credentials": "testCredentials"
}

مثال على "بث فيديو حسب الطلب":

{
  "media": {
    "contentId": "tos",
    "contentUrl": "https://storage.googleapis.com/interactive-media-ads/media/tos.m3u8",
    "streamType": "BUFFERED",
    "customData": {
      "contentSourceId": "2548831",
      "videoId": "tears-of-steel",
      "ApiKey": "",
      "senderCanSkip": true
    }
  },
  "credentials": "testCredentials"
}