Müşteriyi kapsül yayınlama yönlendirmesine hazırlama

Bu kılavuzda, kapsül yayınlama API'si ve manifest değiştirme aracınızla bir HLS veya DASH canlı yayını yüklemek için istemci uygulama geliştirme konusu ele alınmaktadır.

Ön koşullar

Devam etmeden önce aşağıdakilere sahip olmanız gerekir:

Akış isteğinde bulunma

Kullanıcınız bir akış seçtiğinde aşağıdakileri yapın:

  1. Canlı yayın hizmeti yöntemine bir POST isteği gönderin. Ayrıntılı bilgi için Method: stream (Yöntem: akış) başlıklı makaleyi inceleyin.

  2. Reklam hedefleme parametrelerini application/x-www-form-urlencoded veya application/json biçimlerinde iletin. Bu istek, Google DAI'ye bir akış oturumu kaydeder.

    Aşağıdaki örnekte bir akış isteği gönderilmektedir:

    Form kodlaması

    const url = `https://dai.google.com/ssai/pods/api/v1/` +
          `network/NETWORK_CODE/custom_asset/CUSTOM_ASSET_KEY/stream`;
    
    const params = new URLSearchParams({
            cust_params: 'section=sports&page=golf,tennis'
    }).toString();
    
    const response = await fetch(url, {
            method: 'POST',
            headers: {
              'Content-Type': 'application/x-www-form-urlencoded'
            },
            body: params
    });
    
    console.log(await response.json());
    

    JSON kodlaması

    const url = `https://dai.google.com/ssai/pods/api/v1/` +
          `network/NETWORK_CODE/custom_asset/CUSTOM_ASSET_KEY/stream`;
    
    const response = await fetch(url, {
            method: 'POST',
            headers: {
              'Content-Type': 'application/json'
            },
            body: JSON.stringify({
              cust_params: {
                section: 'sports',
                page: 'golf,tennis'
              }
            })
    });
    
    console.log(await response.json());
    

    İşlem başarılı olursa şuna benzer bir çıkış görürsünüz:

    {
    "stream_id": "c4a5dad5-aaa8-4550-8acb-7cda3cdb21bb:DLS",
    "media_verification_url": "https://dai.google.com/view/.../event/c14aZDWtQg-ZwQaEGl6bYA/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/.../metadata",
    "session_update_url": "https://dai.google.com/linear/.../session",
    "polling_frequency": 10
    }
    
  3. JSON yanıtında akış oturumu kimliğini bulun ve sonraki adımlar için diğer verileri depolayın.

Anket reklamı meta verileri

Reklam meta verilerini sorgulamak için aşağıdakileri yapın:

  1. Akış kaydı yanıtından metadata_url değerini okuyun.

  2. metadata_url uç noktasına ilk GET isteğini gönderin.

    • delta_token sorgu parametresini çıkarın. Bu işlem, sunucunun akışın dijital video kaydedici (DVR) penceresi için tüm meta verileri döndürmesini sağlar. DVR aralığı, izleyicinin geri sarıp oynatabileceği yayın süresini içerir. Yanıtta next_delta_token alanı var.
  3. Bant genişliğini optimize etmek için en son yanıttaki next_delta_token değerini saklayın.

  4. Bir sonraki isteğinizde bu değeri delta_token sorgu parametresi olarak gönderin. Sunucu, yalnızca jeton oluşturulduktan sonra değişen meta verileri döndürür. Her zaman aldığınız en son jetonu gönderin. Jetonu ayrıştırmaya, değiştirmeye veya oluşturmaya çalışmayın. Ayrıntılar için Method: metadata (Yöntem: meta veriler) başlıklı makaleyi inceleyin.

    Aşağıdaki örnekte reklam meta verileri getirilmektedir:

    // Initial request (returns full metadata and next_delta_token)
    let response = await fetch(metadata_url);
    let metadata = await response.json();
    let deltaToken = metadata.next_delta_token;
    
    // Subsequent request (returns only changes since deltaToken)
    if (deltaToken) {
      const url = new URL(metadata_url);
      url.searchParams.append('delta_token', deltaToken);
      response = await fetch(url.toString());
      const deltaMetadata = await response.json();
      // Merge deltaMetadata into your local cache
      mergeMetadata(metadata, deltaMetadata);
      deltaToken = deltaMetadata.next_delta_token;
    }
    

    İşlem başarılı olursa PodMetadata yanıtını alırsınız. delta_token parametresini sağlarsanız yanıt yalnızca sunucunun jetonu oluşturmasından sonra sunucu tarafından eklenen veya güncellenen reklamları, reklam aralarını ve etiketleri içerir. Yanıtta yeni bir next_delta_token değeri de yer alır. Eski reklam araları varsa yanıtta, önbelleğinizden kaldırılacak reklam aralarının obsolete_ad_break_ids listesi de yer alır.

    {
      "next_delta_token": "eyJyYW5nZXMiOlt7InMiOjEsImUiOjN9XX0",
      "obsolete_ad_break_ids": ["0003069407"],
      "tags":{
        "google_1022389921":{
          "ad":"0003069408_ad1",
          "ad_break_id":"0003069408",
          "type":"start"
        },
        ...
      },
      "ads":{
        "0003069408_ad1":{
          "ad_break_id":"0003069408",
          "position":1,
          "duration":10.01,
          "title":"External - Pod Midroll 1",
          "clickthrough_url":"https://.../",
          ...
        },
        ...
      },
      "ad_breaks":{
        "0003069408":{
          "type":"mid",
          "duration":30,
          "ads":3
        },
        ...
      }
    }
    
  5. tags nesnesini kaydedin ve güncellemeleri yerel önbelleğinizle birleştirin. obsolete_ad_break_ids parametresi varsa bu reklam aralarını ve ilişkili reklamlar ile etiketleri önbelleğinizden kaldırın.

  6. Meta verileri düzenli olarak istemek için polling_frequency değerini kullanarak bir zamanlayıcı ayarlayın. Her yoklamada, en son meta veri yanıtında döndürülen next_delta_token değerini delta_token sorgu parametresi olarak gönderin.

Yayını video oynatıcınıza yükleme

Kayıt yanıtından oturum kimliğini aldıktan sonra kimliği manifest değiştirme aracınıza iletin veya akışı bir video oynatıcıya yüklemek için manifest URL'si oluşturun.

Oturum kimliğini iletmek için manifest değiştirme aracı belgelerinize bakın. Manifest değiştirme aracı geliştiriyorsanız Canlı yayın için manifest değiştirme aracı başlıklı makaleyi inceleyin.

Aşağıdaki örnekte bir manifest URL'si oluşturulmaktadır:

https://<your_manifest_manipulator_url>/manifest.m3u8?DAI_stream_ID=SESSION_ID&network_code=NETWORK_CODE&DAI_custom_asset_key=CUSTOM_ASSET_KEY"

Oynatıcınız hazır olduğunda oynatmayı başlatın.

Reklam etkinliklerini dinleme

Zamanlanmış meta veriler için yayınınızın kapsayıcı biçimini kontrol edin:

  • Taşıma Akışı (TS) kapsayıcıları içeren HLS akışları, zamanlanmış meta verileri taşımak için zamanlanmış ID3 etiketlerini kullanır. Ayrıntılar için HTTP Canlı Yayın (HLS) ile Ortak Medya Uygulama Biçimi hakkında başlıklı makaleyi inceleyin.

  • DASH akışları, manifestteki etkinlikleri belirtmek için EventStream öğelerini kullanır.

  • DASH akışları, segmentler ID3 etiketleri de dahil olmak üzere yük verileri için Etkinlik Mesajı (emsg) kutuları içerdiğinde InbandEventStream öğelerini kullanır. Ayrıntılı bilgi için InbandEventStream sayfasına bakın.

  • DASH ve HLS dahil olmak üzere CMAF akışları, ID3 etiketleri içeren emsg kutularını kullanır.

Yayınınızdan ID3 etiketlerini almak için video oynatıcınızın kılavuzuna bakın. Ayrıntılı bilgi için Zamanlanmış meta verileri işleme kılavuzuna bakın.

Reklam etkinliği kimliğini ID3 etiketlerinden almak için aşağıdakileri yapın:

  1. Etkinlikleri urn:google:dai:2018 veya https://aomedia.org/emsg/ID3 ile scheme_id_uri ölçütüne göre filtreleyin.
  2. message_data alanından bayt dizisini ayıklayın.

    Aşağıdaki örnekte, emsg verilerinin kodu JSON biçiminde çözülmektedir:

    {
      "scheme_id_uri": "https://developer.apple.com/streaming/emsg-id3",
      "presentation_time": 27554,
      "timescale": 1000,
      "message_data": "ID3TXXXgoogle_1022389921",
      ...
    }
    
  3. ID3 etiketlerini TXXXgoogle_{ad_event_ID} biçimiyle filtreleyin:

    TXXXgoogle_1022389921
    

Reklam etkinliği verilerini göster

TagSegment nesnesini bulmak için aşağıdakileri yapın:

  1. Reklam meta verilerini yokla'dan reklam meta verileri tags nesnesini alın. tags nesnesi, TagSegment nesnelerinin bir dizisidir.

  2. progress türünde bir TagSegment nesnesi bulmak için tam reklam etkinliği kimliğini kullanın.

  3. Diğer türlerdeki bir TagSegment nesnesini bulmak için reklam etkinliği kimliğinin ilk 17 karakterini kullanın.

    İstemci uygulamanız reklam meta verilerini düzenli olarak sorguladığından, video oynatıcınızın akışta bir ID3 etiketiyle karşılaşması ile ilişkili meta verilerin kullanılabilir hale gelmesi arasında gecikme olabilir. İstemci uygulamanız, depolanan etiketlerde bir ID3 etiketi bulamazsa etiketi bir sıraya alın ve bir sonraki meta veri sorgulamasından sonra etiketi yeniden işleyin. İşlem tamamlanana kadar etiketi sırada tutun.

  4. TagSegment değerini aldıktan sonra, reklam meta verileri ad_breaks nesnesinde AdBreak nesnesini bulmak için ad_break_id mülkünü anahtar olarak kullanın.

    Aşağıdaki örnekte bir AdBreak nesnesi bulunur:

    {
      "type":"mid",
      "duration":15,
      "ads":1
    }
    
  5. Reklam arasında reklam konumuyla ilgili bilgileri göstermek için TagSegment ve AdBreak verilerini kullanın. Örneğin, Ad 1 of 3.

Medya doğrulama ping'leri gönderme

progress türü hariç her reklam etkinliği için bir medya doğrulama ping'i gönderin. Google DAI, progress etkinliklerini siler ve bu etkinliklerin sık sık gönderilmesi uygulama performansınızı etkileyebilir.

Bir reklam etkinliğinin tam medya doğrulama URL'sini oluşturmak için aşağıdakileri yapın:

  1. Akış yanıtından, tam reklam etkinliği kimliğini media_verification_url değerine ekleyin.

  2. Tam URL ile bir GET isteği gönderin:

    // media_verification_url: "https://dai.google.com/view/.../event/c14aZDWtQg-ZwQaEGl6bYA/media/"
    const completeUrl = `${media_verification_url}google_1022389921`;
    
    const response = await fetch(completeUrl);
    

    İşlem başarılı olursa 202 kod durum yanıtı alırsınız. Aksi takdirde 404 hata kodunu alırsınız.

Tüm reklam etkinliklerinin geçmiş günlüğünü incelemek için Yayın Etkinliği İzleyicisi'ni (SAM) kullanabilirsiniz. Ayrıntılı bilgi için Canlı yayını izleme ve canlı yayınla ilgili sorunları giderme başlıklı makaleyi inceleyin.