Pisanie aplikacji dla nadawców na potrzeby pakietu CAF DAI SDK

W przeciwieństwie do wcześniejszych integracji między Chromecastem a DAI pakiet SDK CAF DAI skupia się na utrzymaniu standardów i oczekiwań określonych przez platformę aplikacji Cast. W związku z tym nie ma konieczności intensywnego dostosowywania aplikacji nadawcy do zarządzania dwukierunkową komunikacją między IMA a aplikacją. Komunikacja ta jest teraz realizowana przez zintegrowaną funkcję Przerwy na reklamy w CAF, co nie wymaga korzystania z niestandardowych systemów komunikacji do komunikacji między aplikacją nadawcy a odbiorcą.

W zależności od nadawcy konieczne może być dodanie ograniczonego kodu do nadawców, aby w pełni włączyć obsługę przerw na reklamy CAF, np. dodanie obsługi reklam możliwych do pominięcia dla nadawców internetowych.

Obecnie oprócz obsługi przerw na reklamy CAF należy umieścić dane strumienia DAI w obiekcie CAF MediaInfo wysyłanym od nadawcy do odbiornika. Dane te możesz wysyłać na wiele sposobów. Możesz na przykład zakodować na stałe parametr contentSourceID na odbiorniku i przesłać jedynie parametr videoID za pomocą obiektu MediaInfo. Możesz też wysłać dowolny identyfikator do odbiornika, a potem wysłać zapytanie do bazy danych online, aby poznać rzeczywiste parametry DAI.

Jednak dla uproszczenia wszystkie przykłady w naszych przykładach zakładają, że obiekty MediaInfo podlegają tej konwencji nazewnictwa i nazw:

contentId Unikalny identyfikator tego elementu multimedialnego
contentUrl URL strumienia kreacji, który ma zostać załadowany, jeśli z jakiegoś powodu żądanie strumienia DAI nie powiedzie się
streamType. W przypadku transmisji na żywo ta wartość powinna mieć wartość „NA ŻYWO”. W przypadku strumieni VOD wartość powinna mieć wartość „BUFFERED”.
niestandardowe_dane assetKey Tylko transmisje na żywo. Identyfikuje transmisję na żywo do wczytania
contentSourceId Tylko strumienie VOD Identyfikuje kanał mediów zawierający żądany strumień.
identyfikator filmu Tylko strumienie VOD Identyfikuje wybrany strumień w określonym kanale mediów.
Klucz interfejsu API Opcjonalny klucz interfejsu API, który może być wymagany do pobrania adresu URL strumienia z pakietu IMA DAI SDK.
senderCanSkip Wartość logiczna, która informuje odbiorcę, czy urządzenie wysyłające umożliwia wyświetlanie przycisku pominięcia, co umożliwia obsługę reklam możliwych do pominięcia.

Przykładowa transmisja na żywo:

{
  "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"
}

Przykładowy strumień VOD:

{
  "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"
}