حزمة تطوير البرامج (SDK) الخاصة بميزة "إدراج الإعلانات الديناميكي" من Google على Chromecast
على عكس عمليات الدمج السابقة بين Chromecast وDAI، يركّز حزمة تطوير البرامج (SDK) لـ CAF DAI بشكل كبير على الحفاظ على المعايير والتوقّعات التي وضعها إطار عمل تطبيقات Cast. وبالتالي، لا توجد متطلبات لتخصيص تطبيقات المرسِل بشكل كبير من أجل إدارة الاتصالات الثنائية الاتجاه بين IMA وتطبيق المرسِل. تتم الآن إدارة هذه الاتصالات من خلال وظيفة فواصل إعلانية في CAF المدمجة، بدلاً من الحاجة إلى أنظمة رسائل مخصّصة للتواصل بين تطبيق المرسِل والجهاز المستقبِل.
استنادًا إلى جهاز الإرسال الذي تستخدمه، قد تحتاج إلى إضافة بعض الرموز البرمجية المحدودة إلى أجهزة الإرسال لتفعيل ميزة "فواصل إعلانية في CAF" بالكامل، مثل إتاحة عرض الإعلانات القابلة للتخطّي على أجهزة إرسال الويب.
كل ما هو مطلوب الآن، بالإضافة إلى إتاحة "فواصل إعلانية في CAF"، هو تضمين بيانات بث "إعلانات البث المباشر" في عنصر CAF MediaInfo الذي يتم إرساله من المرسِل إلى المستلِم. يمكنك اختيار إرسال هذه البيانات بعدّة طرق مختلفة، مثلاً، يمكنك ترميز contentSourceID بشكل ثابت على جهاز الاستقبال وإرسال videoID فقط مع عنصر MediaInfo، أو يمكنك إرسال معرّف عشوائي إلى جهاز الاستقبال، ومن هناك طلب البحث في قاعدة بيانات على الإنترنت عن مَعلمات "إدراج الإعلانات الديناميكي" الفعلية.
ومع ذلك، ولتبسيط الأمر، ستفترض جميع عيّناتنا أنّك تتّبع هذا البنية البسيطة واصطلاح التسمية لكائنات MediaInfo:
| contentId | معرّف فريد لعنصر الوسائط هذا | |
| contentUrl | عنوان URL للبث الاحتياطي الذي سيتم تحميله في حال تعذّر تنفيذ DAI StreamRequest لأي سبب من الأسباب | |
| streamType | بالنسبة إلى أحداث البث المباشر، يجب ضبط هذه القيمة على LIVE. بالنسبة إلى بث الفيديو عند الطلب، يجب ضبط هذه القيمة على BUFFERED | |
| customData | assetKey | أحداث البث المباشر فقط تحدّد هذه السمة البث المباشر الذي سيتم تحميله |
| contentSourceId | أحداث البث المباشر للفيديوهات عند الطلب فقط تحدّد هذه السمة خلاصة الوسائط التي تحتوي على البث المطلوب. | |
| videoId | أحداث البث المباشر للفيديوهات عند الطلب فقط تحدّد هذه السمة البث المطلوب ضِمن خلاصة الوسائط المحدّدة. | |
| ApiKey | مفتاح API اختياري يمكن أن يكون مطلوبًا لاسترداد عنوان URL الخاص ببث الفيديو من حزمة تطوير البرامج لإعلانات الوسائط التفاعلية (IMA) الخاصة بالإعلانات الديناميكية داخل الفيديو | |
| senderCanSkip | قيمة منطقية لإعلام جهاز الاستقبال بما إذا كان جهاز الإرسال لديه القدرة على عرض زر تخطّي، ما يتيح عرض إعلانات قابلة للتخطّي | |
مثال على بث مباشر:
{
"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"
}