Hướng dẫn này trình bày cách phát triển một ứng dụng khách để tải sự kiện phát trực tiếp HLS hoặc DASH bằng API Phân phát nhóm và trình thao tác tệp kê khai.
Điều kiện tiên quyết
Để tiếp tục, bạn phải có những thông tin sau:
Khoá thành phần tuỳ chỉnh cho một sự kiện phát trực tiếp được định cấu hình bằng loại DAI
Pod serving redirect. Để lấy khoá này, hãy làm theo các bước sau:Sử dụng thư viện ứng dụng API SOAP để gọi phương thức
LiveStreamEventService.createLiveStreamEventsbằng đối tượngLiveStreamEventvà thuộc tínhdynamicAdInsertionTypeđược đặt thành giá trị enumPOD_SERVING_REDIRECT. Để biết tất cả thư viện ứng dụng, hãy xem phần Thư viện ứng dụng và mã ví dụ.
Xác định xem SDK Quảng cáo trên phương tiện truyền thông tương tác (IMA) có được cung cấp cho nền tảng của bạn hay không. Bạn nên sử dụng SDK IMA để tăng doanh thu. Để biết thông tin chi tiết, hãy xem bài viết Thiết lập SDK IMA cho DAI.
Gửi yêu cầu phát trực tiếp
Khi người dùng chọn một luồng, hãy làm như sau:
Gửi yêu cầu
POSTđến phương thức dịch vụ phát trực tiếp. Để biết thông tin chi tiết, hãy xem phần Phương thức: stream.Truyền các tham số nhắm mục tiêu quảng cáo ở định dạng
application/x-www-form-urlencodedhoặcapplication/json. Yêu cầu này đăng ký một phiên phát trực tuyến với Google DAI.Ví dụ sau đây tạo một yêu cầu truyền trực tuyến:
Mã hoá biểu mẫu
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());Mã hoá JSON
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());Nếu thành công, bạn sẽ thấy kết quả tương tự như sau:
{ "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 }Trong phản hồi JSON, hãy tìm mã phiên phát trực tuyến và lưu trữ dữ liệu khác cho các bước tiếp theo.
Siêu dữ liệu quảng cáo thăm dò ý kiến
Để thăm dò siêu dữ liệu quảng cáo, hãy làm như sau:
Đọc giá trị
metadata_urltừ phản hồi đăng ký luồng.Gửi yêu cầu
GETban đầu đến điểm cuốimetadata_url.- Bỏ qua tham số truy vấn
delta_token. Quá trình này cho phép máy chủ trả về siêu dữ liệu đầy đủ cho phần ghi bằng Trình phát video kỹ thuật số (DVR) của luồng phát. Phần ghi bằng DVR chứa khung thời gian của chương trình phát sóng mà người xem có thể tua lại và phát. Phản hồi bao gồm một trườngnext_delta_token.
- Bỏ qua tham số truy vấn
Để tối ưu hoá băng thông, hãy lưu trữ giá trị
next_delta_tokentừ phản hồi gần đây nhất.Trong yêu cầu tiếp theo, hãy gửi giá trị đó dưới dạng tham số truy vấn
delta_token. Máy chủ chỉ trả về siêu dữ liệu đã thay đổi kể từ khi mã thông báo đó được tạo. Luôn gửi mã thông báo mới nhất mà bạn nhận được. Đừng cố phân tích cú pháp, sửa đổi hoặc tạo mã thông báo. Để biết thông tin chi tiết, hãy xem phần Phương thức: siêu dữ liệu.Ví dụ sau đây tìm nạp siêu dữ liệu quảng cáo:
// 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; }Nếu thành công, bạn sẽ nhận được phản hồi PodMetadata. Nếu bạn cung cấp tham số
delta_token, thì phản hồi chỉ chứa quảng cáo, điểm chèn quảng cáo và thẻ mà máy chủ đã thêm hoặc cập nhật kể từ khi máy chủ tạo mã thông báo. Phản hồi cũng chứa một giá trịnext_delta_tokenmới. Nếu có bất kỳ điểm chèn quảng cáo nào đã lỗi thời, thì phản hồi cũng sẽ bao gồm một danh sáchobsolete_ad_break_idsgồm các điểm chèn quảng cáo cần xoá khỏi bộ nhớ đệm.{ "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 }, ... } }Lưu đối tượng
tagsvà hợp nhất nội dung cập nhật vào bộ nhớ đệm cục bộ. Nếu có tham sốobsolete_ad_break_ids, hãy xoá các điểm chèn quảng cáo đó cũng như quảng cáo và thẻ liên quan khỏi bộ nhớ đệm.Đặt bộ hẹn giờ bằng giá trị
polling_frequencyđể thường xuyên yêu cầu siêu dữ liệu. Trong mỗi lần thăm dò ý kiến, hãy gửi giá trịnext_delta_tokenđược trả về trong phản hồi siêu dữ liệu gần đây nhất dưới dạng tham số truy vấndelta_token.
Tải luồng vào trình phát video
Sau khi bạn có mã phiên từ phản hồi đăng ký, hãy chuyển mã đó đến trình thao tác tệp kê khai hoặc tạo một URL tệp kê khai để tải luồng vào trình phát video.
Để truyền mã phiên, hãy xem tài liệu về trình thao tác tệp kê khai. Nếu bạn phát triển một trình thao tác tệp kê khai, hãy xem bài viết Trình thao tác tệp kê khai cho sự kiện phát trực tiếp.
Ví dụ sau đây minh hoạ cách tập hợp một URL tệp kê khai:
https://<your_manifest_manipulator_url>/manifest.m3u8?DAI_stream_ID=SESSION_ID&network_code=NETWORK_CODE&DAI_custom_asset_key=CUSTOM_ASSET_KEY"
Khi trình phát đã sẵn sàng, hãy bắt đầu phát.
Theo dõi các sự kiện quảng cáo
Kiểm tra định dạng vùng chứa của sự kiện phát trực tiếp để tìm siêu dữ liệu theo thời gian:
Luồng HLS có vùng chứa Luồng truyền tải (TS) sử dụng thẻ ID3 theo thời gian để mang siêu dữ liệu theo thời gian. Để biết thông tin chi tiết, hãy xem bài viết Giới thiệu về Định dạng ứng dụng đa phương tiện phổ biến có tính năng Phát trực tuyến dựa trên HTTP (HLS).
Luồng DASH sử dụng các phần tử
EventStreamđể chỉ định sự kiện trong tệp kê khai.Luồng DASH sử dụng các phần tử
InbandEventStreamkhi các phân đoạn chứa hộp Thông báo sự kiện (emsg) cho dữ liệu tải trọng, bao gồm cả thẻ ID3. Để biết thông tin chi tiết, hãy xem InbandEventStream.Luồng CMAF, bao gồm cả DASH và HLS, sử dụng các hộp
emsgchứa thẻ ID3.
Để truy xuất thẻ ID3 từ luồng phát trực tiếp, hãy tham khảo hướng dẫn của trình phát video. Để biết thông tin chi tiết, vui lòng xem Hướng dẫn xử lý siêu dữ liệu theo thời gian
Để truy xuất mã sự kiện quảng cáo từ thẻ ID3, hãy làm như sau:
- Lọc các sự kiện theo
scheme_id_uribằngurn:google:dai:2018hoặchttps://aomedia.org/emsg/ID3. Trích xuất mảng byte từ trường
message_data.Ví dụ sau đây giải mã dữ liệu
emsgthành JSON:{ "scheme_id_uri": "https://developer.apple.com/streaming/emsg-id3", "presentation_time": 27554, "timescale": 1000, "message_data": "ID3TXXXgoogle_1022389921", ... }Lọc thẻ ID3 theo định dạng
TXXXgoogle_{ad_event_ID}:TXXXgoogle_1022389921
Hiện dữ liệu sự kiện quảng cáo
Để tìm đối tượng TagSegment, hãy làm như sau:
Truy xuất đối tượng siêu dữ liệu quảng cáo
tagstừ Siêu dữ liệu quảng cáo thăm dò ý kiến. Đối tượngtagslà một mảng gồm các đối tượngTagSegment.Sử dụng mã sự kiện quảng cáo đầy đủ để tìm đối tượng
TagSegmentcó loạiprogress.Sử dụng 17 ký tự đầu tiên của mã sự kiện quảng cáo để tìm đối tượng
TagSegmentthuộc các loại khác.Vì ứng dụng khách của bạn thăm dò siêu dữ liệu quảng cáo theo định kỳ, nên có thể xảy ra độ trễ giữa thời điểm trình phát video của bạn gặp thẻ ID3 trong luồng và thời điểm siêu dữ liệu liên quan có sẵn. Nếu ứng dụng khách của bạn không tìm thấy thẻ ID3 trong các thẻ được lưu trữ, hãy giữ thẻ đó trong hàng đợi và xử lý lại thẻ sau lần thăm dò siêu dữ liệu tiếp theo. Giữ thẻ trong hàng đợi cho đến khi quá trình xử lý hoàn tất.
Sau khi bạn có
TagSegment, hãy sử dụng thuộc tínhad_break_idlàm khoá để tìm đối tượngAdBreaktrong đối tượng siêu dữ liệu quảng cáoad_breaks.Ví dụ sau đây tìm một đối tượng
AdBreak:{ "type":"mid", "duration":15, "ads":1 }Sử dụng dữ liệu
TagSegmentvàAdBreakđể hiển thị thông tin về vị trí quảng cáo trong điểm chèn quảng cáo. Ví dụ:Ad 1 of 3.
Gửi tín hiệu xác minh nội dung nghe nhìn
Đối với mọi sự kiện quảng cáo, ngoại trừ loại progress, hãy gửi một tín hiệu xác minh nội dung nghe nhìn.
Google DAI loại bỏ các sự kiện progress và việc gửi các sự kiện này thường xuyên có thể ảnh hưởng đến hiệu suất của ứng dụng.
Để tạo URL xác minh nội dung nghe nhìn hoàn chỉnh của một sự kiện quảng cáo, hãy làm như sau:
Trong phản hồi của luồng, hãy thêm mã sự kiện quảng cáo đầy đủ vào giá trị
media_verification_url.Tạo yêu cầu
GETbằng URL hoàn chỉnh:// media_verification_url: "https://dai.google.com/view/.../event/c14aZDWtQg-ZwQaEGl6bYA/media/" const completeUrl = `${media_verification_url}google_1022389921`; const response = await fetch(completeUrl);Nếu thành công, bạn sẽ nhận được phản hồi có mã trạng thái
202. Nếu không, bạn sẽ nhận được mã lỗi404.
Bạn có thể sử dụng Trình giám sát hoạt động phát trực tuyến (SAM) để kiểm tra nhật ký trước đây của tất cả sự kiện quảng cáo. Để biết thông tin chi tiết, hãy xem bài viết giám sát và khắc phục sự cố cho sự kiện phát trực tiếp