Hướng dẫn này minh hoạ cách phát một luồng DAI bằng SDK IMA CAF DAI. Nếu bạn muốn xem hoặc làm theo một mẫu tích hợp hoàn chỉnh, hãy tải ví dụ xuống.
Trước khi sử dụng hướng dẫn này, hãy nhớ làm quen với giao thức Bộ thu web của Khung ứng dụng Chromecast. Hướng dẫn này giả định rằng bạn đã có kiến thức cơ bản về các khái niệm của trình thu CAF, chẳng hạn như trình chặn thông báo và đối tượng mediaInformation, cũng như đã quen thuộc với việc sử dụng công cụ Lệnh và điều khiển của Cast để mô phỏng trình gửi CAF.
Để sử dụng IMA DAI, bạn phải có tài khoản Ad Manager 360. Nếu bạn có tài khoản Ad Manager, hãy liên hệ với người quản lý tài khoản của bạn để biết thêm thông tin. Để biết thông tin về cách đăng ký Ad Manager, hãy truy cập vào Trung tâm trợ giúp của Ad Manager.
Để biết thông tin về cách tích hợp với các nền tảng khác hoặc cách sử dụng SDK phía máy khách của IMA, hãy xem SDK quảng cáo trên phương tiện truyền thông tương tác.
Tổng quan về CAF DAI
Việc triển khai DAI bằng IMA CAF DAI SDK bao gồm hai thành phần chính như được minh hoạ trong hướng dẫn này:
StreamRequest: Một đối tượng xác định yêu cầu luồng đến máy chủ quảng cáo của Google. Yêu cầu về luồng có hai loại chính:LiveStreamRequest: chỉ định Khoá thành phần, cũng như các tham số không bắt buộc khác.VODStreamRequest: Chỉ định Mã nguồn nội dung, Mã video cũng như các thông số không bắt buộc khác.- Cả hai loại yêu cầu đều có thể bao gồm khoá API cần thiết để truy cập vào các luồng được chỉ định và mã mạng Google Ad Manager để SDK IMA xử lý giá trị nhận dạng quảng cáo như được chỉ định trong chế độ cài đặt Google Ad Manager.
StreamManager: Một đối tượng xử lý hoạt động giao tiếp giữa luồng video và IMA DAI SDK, chẳng hạn như kích hoạt ping theo dõi và chuyển tiếp sự kiện luồng đến nhà xuất bản.
Điều kiện tiên quyết
- Tài khoản Cast Developer Console có thiết bị thử nghiệm đã đăng ký.
- Một ứng dụng trình thu web được lưu trữ và đăng ký với Cast Developer Console, đồng thời có thể được sửa đổi để lưu trữ mã do hướng dẫn này cung cấp.
- Một ứng dụng gửi được định cấu hình để sử dụng ứng dụng trình nhận web của bạn. Ví dụ này sử dụng công cụ Cast Command and Control làm người gửi.
Định cấu hình đối tượng MediaInfo của người gửi
Trước tiên, hãy định cấu hình đối tượng MediaInfo của ứng dụng gửi để thêm các trường sau:
contentId
|
Giá trị nhận dạng riêng biệt cho mục nội dung nghe nhìn này | |
contentUrl
|
URL của luồng dự phòng để tải nếu DAI StreamRequest không thành công vì bất kỳ lý do nào | |
streamType
|
Đối với sự kiện phát trực tiếp, bạn nên đặt giá trị này thành `LIVE`. Đối với sự kiện phát trực tiếp VOD, bạn nên đặt giá trị này thành `BUFFERED` | |
customData
|
assetKey
|
Chỉ dành cho sự kiện phát trực tiếp. Xác định sự kiện phát trực tiếp cần tải |
contentSourceId
|
Chỉ luồng video theo yêu cầu (VOD). Xác định nguồn cấp dữ liệu nội dung nghe nhìn chứa luồng được yêu cầu. | |
videoId
|
Chỉ luồng video theo yêu cầu (VOD). Xác định luồng được yêu cầu trong nguồn cấp dữ liệu nghe nhìn được chỉ định. | |
networkCode
|
(Không bắt buộc) Mã mạng Google Ad Manager của bạn. | |
ApiKey
|
Khoá API không bắt buộc có thể cần thiết để truy xuất URL của luồng từ IMA DAI SDK | |
senderCanSkip
|
Giá trị boolean để cho thiết bị nhận biết liệu thiết bị gửi có khả năng hiển thị nút bỏ qua hay không, cho phép hỗ trợ quảng cáo có thể bỏ qua | |
Để định cấu hình các giá trị này trong công cụ điều khiển và lệnh truyền, hãy nhấp vào thẻ Load Media (Tải nội dung nghe nhìn) rồi đặt loại yêu cầu tải tuỳ chỉnh thành LOAD. Sau đó, thay thế dữ liệu JSON trong vùng văn bản bằng một trong các đối tượng JSON sau:
TRỰC TIẾP
{
"media": {
"contentId": "bbb",
"contentUrl": "https://storage.googleapis.com/interactive-media-ads/media/bbb.m3u8",
"streamType": "LIVE",
"customData": {
"assetKey": "c-rArva4ShKVIAkNfy6HUQ",
"networkCode": "21775744923",
"ApiKey": "",
"senderCanSkip": true
}
},
"credentials": "testCredentials"
}
VOD
{
"media": {
"contentId": "tos",
"contentUrl": "https://storage.googleapis.com/interactive-media-ads/media/tos.m3u8",
"streamType": "BUFFERED",
"customData": {
"contentSourceId": "2548831",
"videoId": "tears-of-steel",
"networkCode": "21775744923",
"ApiKey": "",
"senderCanSkip": true
}
},
"credentials": "testCredentials"
}
Bạn có thể gửi đối tượng yêu cầu tải tuỳ chỉnh này đến thiết bị nhận để kiểm thử các bước sau.
Tạo một trình thu CAF cơ bản
Làm theo Hướng dẫn về trình thu cơ bản của SDK CAF để tạo một trình thu web cơ bản.
Mã của trình thu nhận sẽ có dạng như sau:
<html>
<head>
<script type="text/javascript"
src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js">
</script>
</head>
<body>
<cast-media-player></cast-media-player>
<script>
cast.framework.CastReceiverContext.getInstance().start();
</script>
</body>
</html>
Nhập IMA DAI SDK và tải Trình quản lý trình phát
Thêm thẻ tập lệnh để nhập IMA DAI SDK cho CAF vào trình thu nhận web, ngay sau tập lệnh tải CAF. SDK DAI CAF luôn được cập nhật nên bạn không cần phải đặt một phiên bản cụ thể. Sau đó, trong thẻ tập lệnh tiếp theo, hãy lưu trữ bối cảnh của trình nhận và trình quản lý trình phát dưới dạng hằng số trước khi khởi động trình nhận.
<html>
<head>
<script type="text/javascript"
src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js"></script>
<script src="//imasdk.googleapis.com/js/sdkloader/cast_dai.js"></script>
</head>
<body>
<cast-media-player></cast-media-player>
<script>
const castContext = cast.framework.CastReceiverContext.getInstance();
const playerManager = castContext.getPlayerManager();
castContext.start();
</script>
</body>
</html>
Khởi chạy Trình quản lý luồng IMA
Khởi chạy Trình quản lý luồng của SDK DAI CAF.
<html>
<head>
<script type="text/javascript"
src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js"></script>
<script src="//imasdk.googleapis.com/js/sdkloader/cast_dai.js"></script>
</head>
<body>
<cast-media-player></cast-media-player>
<script>
const castContext = cast.framework.CastReceiverContext.getInstance();
const playerManager = castContext.getPlayerManager();
const streamManager = new google.ima.cast.dai.api.StreamManager();
castContext.start();
</script>
</body>
</html>
Tạo trình chặn thông báo tải
SDK DAI của CAF sử dụng trình chặn thông báo tải của CAF để tạo yêu cầu truyền phát và thay thế URL nội dung bằng luồng DAI cuối cùng.
Trình chặn thông báo gọi streamManager.requestStream() để xử lý việc đặt điểm chèn quảng cáo, yêu cầu luồng và thay thế contentURL hiện có.
Chỉ có thể có một trình chặn thông báo tải, vì vậy, nếu ứng dụng của bạn yêu cầu sử dụng trình chặn, bạn cần kết hợp mọi hàm tuỳ chỉnh vào cùng một lệnh gọi lại.
<html>
<head>
<script type="text/javascript"
src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js"></script>
<script src="//imasdk.googleapis.com/js/sdkloader/cast_dai.js"></script>
</head>
<body>
<cast-media-player></cast-media-player>
<script>
const castContext = cast.framework.CastReceiverContext.getInstance();
const playerManager = castContext.getPlayerManager();
const streamManager = new google.ima.cast.dai.api.StreamManager();
const getStreamRequest = (request) => null;
playerManager.setMessageInterceptor(
cast.framework.messages.MessageType.LOAD, (request) => {
return streamManager.requestStream(request, getStreamRequest(request))
.then((request) => {
this.broadcast('Stream request successful.');
return Promise.resolve(request);
})
.catch((error) => {
this.broadcast('Stream request failed.');
return Promise.resolve(request);
});
});
castContext.start();
</script>
</body>
</html>
Tạo yêu cầu luồng phát
Để hoàn tất quá trình tích hợp CAF DAI, bạn cần tạo yêu cầu
luồng
bằng cách sử dụng dữ liệu có trong đối tượng mediaInfo từ người gửi.
<html>
<head>
<script type="text/javascript"
src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js"></script>
<script src="//imasdk.googleapis.com/js/sdkloader/cast_dai.js"></script>
</head>
<body>
<cast-media-player></cast-media-player>
<script>
const castContext = cast.framework.CastReceiverContext.getInstance();
const playerManager = castContext.getPlayerManager();
const streamManager = new google.ima.cast.dai.api.StreamManager();
const getStreamRequest = (request) => {
const imaRequestData = request.media.customData;
let streamRequest = null;
if (imaRequestData.assetKey) {
// Live stream
streamRequest = new google.ima.cast.dai.api.LiveStreamRequest();
streamRequest.assetKey = imaRequestData.assetKey;
} else if (imaRequestData.contentSourceId) {
// VOD stream
streamRequest = new google.ima.cast.dai.api.VODStreamRequest();
streamRequest.contentSourceId = imaRequestData.contentSourceId;
streamRequest.videoId = imaRequestData.videoId;
}
if (streamRequest && imaRequestData.networkCode) {
streamRequest.networkCode = imaRequestData.networkCode;
}
if (streamRequest && imaRequestData.ApiKey) {
streamRequest.ApiKey = imaRequestData.ApiKey;
}
if (streamRequest && imaRequestData.senderCanSkip) {
streamRequest.senderCanSkip = imaRequestData.senderCanSkip;
}
return streamRequest;
};
playerManager.setMessageInterceptor(
cast.framework.messages.MessageType.LOAD, (request) => {
return streamManager.requestStream(request, getStreamRequest(request))
.then((request) => {
return Promise.resolve(request);
})
.catch((error) => {
this.broadcast('Stream request failed.');
return Promise.resolve(request);
});
});
castContext.start();
</script>
</body>
</html>
Giờ đây, bạn có thể yêu cầu và phát lại các luồng DAI bằng SDK DAI CAF của Google. Để tìm hiểu thêm về các tính năng nâng cao của SDK, hãy xem các hướng dẫn khác hoặc tải ứng dụng nhận mẫu của chúng tôi xuống.