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:
Pod serving redirectDAI türüyle yapılandırılmış bir canlı yayın etkinliği için özel öğe anahtarı. Bu anahtarı almak için aşağıdaki adımları uygulayın:LiveStreamEventService.createLiveStreamEventsyöntemini birLiveStreamEventnesnesi vePOD_SERVING_REDIRECTenum değerine ayarlanmışdynamicAdInsertionTypeözelliğiyle çağırmak için bir SOAP API istemci kitaplığı kullanın. Tüm istemci kitaplıkları için İstemci kitaplıkları ve örnek kod bölümüne bakın.
Interactive Media Ads (IMA) SDK'sının platformunuzda kullanılıp kullanılamayacağını belirleyin. Geliri artırmak için IMA SDK'yı kullanmanızı öneririz. Ayrıntılar için DAI için IMA SDK'sını ayarlama bölümüne bakın.
Akış isteğinde bulunma
Kullanıcınız bir akış seçtiğinde aşağıdakileri yapın:
Canlı yayın hizmeti yöntemine bir
POSTisteği gönderin. Ayrıntılı bilgi için Method: stream (Yöntem: akış) başlıklı makaleyi inceleyin.Reklam hedefleme parametrelerini
application/x-www-form-urlencodedveyaapplication/jsonbiç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 }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:
Akış kaydı yanıtından
metadata_urldeğerini okuyun.metadata_urluç noktasına ilkGETisteğini gönderin.delta_tokensorgu 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ıttanext_delta_tokenalanı var.
Bant genişliğini optimize etmek için en son yanıttaki
next_delta_tokendeğerini saklayın.Bir sonraki isteğinizde bu değeri
delta_tokensorgu 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_tokenparametresini 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 birnext_delta_tokendeğeri de yer alır. Eski reklam araları varsa yanıtta, önbelleğinizden kaldırılacak reklam aralarınınobsolete_ad_break_idslistesi 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 }, ... } }tagsnesnesini kaydedin ve güncellemeleri yerel önbelleğinizle birleştirin.obsolete_ad_break_idsparametresi varsa bu reklam aralarını ve ilişkili reklamlar ile etiketleri önbelleğinizden kaldırın.Meta verileri düzenli olarak istemek için
polling_frequencydeğerini kullanarak bir zamanlayıcı ayarlayın. Her yoklamada, en son meta veri yanıtında döndürülennext_delta_tokendeğerinidelta_tokensorgu 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ğindeInbandEventStreamöğ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
emsgkutuları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:
- Etkinlikleri
urn:google:dai:2018veyahttps://aomedia.org/emsg/ID3ilescheme_id_uriölçütüne göre filtreleyin. message_dataalanından bayt dizisini ayıklayın.Aşağıdaki örnekte,
emsgverilerinin 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", ... }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:
Reklam meta verilerini yokla'dan reklam meta verileri
tagsnesnesini alın.tagsnesnesi,TagSegmentnesnelerinin bir dizisidir.progresstüründe birTagSegmentnesnesi bulmak için tam reklam etkinliği kimliğini kullanın.Diğer türlerdeki bir
TagSegmentnesnesini 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.
TagSegmentdeğerini aldıktan sonra, reklam meta verileriad_breaksnesnesindeAdBreaknesnesini bulmak içinad_break_idmülkünü anahtar olarak kullanın.Aşağıdaki örnekte bir
AdBreaknesnesi bulunur:{ "type":"mid", "duration":15, "ads":1 }Reklam arasında reklam konumuyla ilgili bilgileri göstermek için
TagSegmentveAdBreakverilerini 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:
Akış yanıtından, tam reklam etkinliği kimliğini
media_verification_urldeğerine ekleyin.Tam URL ile bir
GETisteğ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
202kod durum yanıtı alırsınız. Aksi takdirde404hata 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.