选择您感兴趣的 DAI 解决方案
广告连播投放 DAI
IMA SDK 可简化将多媒体广告集成到网站和应用中的过程。
IMA SDK 可从任何符合 VAST 标准的广告服务器请求广告，并管理您应用中的广告播放。
使用 IMA DAI SDK 时，应用会针对 VOD 或直播内容发出广告和内容视频的视频流请求。然后，SDK 会返回组合的视频流，因此您无需在应用中管理广告与内容视频之间的切换。
本指南演示了如何使用适用于 CAF 的 IMA DAI SDK 播放直播 DAI Pod Serving 视频流。
在使用本指南之前，请先熟悉 Chromecast 应用框架的 Web 接收器协议。本指南假定您对 CAF 接收器概念（例如消息拦截器和 mediaInformation 对象）有基本的了解，并熟悉使用 Cast 命令和控制工具来模拟 CAF 发送器。
若要使用 IMA DAI 广告连播投放，您必须与广告连播投放合作伙伴合作，并且必须拥有 Ad Manager 360 高级版帐号。如果您有 Ad Manager 账号，请与您的客户经理联系以了解详情。如需了解如何注册 Ad Manager，请访问 Ad Manager 帮助中心。
如需了解如何与其他平台集成或使用 IMA 客户端 SDK，请参阅互动式媒体广告 SDK。
IMA DAI Pod Serving 概览
使用 IMA CAF DAI SDK 实现广告连播投放涉及两个主要组件，本指南将对此进行演示：
StreamRequest：用于定义向 Google 广告服务器的数据流请求的对象。请求会指定网络代码、自定义资产密钥、可选的 API 密钥以及其他可选参数。StreamManager：用于处理视频流与 IMA DAI SDK 之间的通信的对象，例如触发跟踪 ping 以及将视频流事件转发给发布商。
前提条件
- 一个已注册测试设备的 Cast Developer Console 帐号。
- 一个托管的网页接收器应用，您已向 Cast Developer Console 注册此应用，该应用可进行修改，以托管本指南提供的代码。
- 一个配置为使用网络接收器应用的发送应用。在本示例中，请使用投放命令和控制工具作为发送器。
配置发送者的 MediaInfo 对象
首先，配置发送者应用的 MediaInfo 对象，以添加以下字段：
| 字段 | 目录 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
contentId
|
此媒体项的唯一标识符。
CONTENT_ID |
||||||||||
contentUrl
|
可选。在 DAI 视频流加载失败时要播放的备用视频流网址。
BACKUP_STREAM_URL |
||||||||||
contentType
|
可选。内容备用视频流的 MIME 类型。仅 DASH 视频流需要。
CONTENT_STREAM_MIMETYPE |
||||||||||
streamType
|
用于此值的字符串字面量或常量因发送者平台而异。 | ||||||||||
customData
|
customData 字段包含由其他必填字段组成的键值对存储区。
|
以下是一些可帮助您上手的代码示例：
网站
如需在 Cast 网页发送器中配置这些值，请先创建包含所需数据的 MediaInfo 对象，然后向网络接收器发出加载请求。
// Create mediaInfo object
const mediaInfo = new chrome.cast.media.MediaInfo("CONTENT_ID");
mediaInfo.contentUrl = "BACKUP_STREAM_URL";
mediaInfo.contentType = "CONTENT_STREAM_MIMETYPE";
mediaInfo.streamType = chrome.cast.media.StreamType.LIVE;
mediaInfo.customData = {
manifestUrl: "MANIFEST_URL",
networkCode: "NETWORK-CODE",
customAssetKey: "CUSTOM_ASSET_KEY",
apiKey: "API_KEY"
};
// Make load request to cast web receiver
const castSession = cast.framework.CastContext.getInstance().getCurrentSession();
const request = new chrome.cast.media.LoadRequest(mediaInfo);
castSession.loadMedia(request).then(
() => { console.log('Load succeed'); },
(errorCode) => { console.log('Error code: ' + errorCode); });
Android
如需在 Cast 网页发送器中配置这些值，请先创建包含所需数据的 MediaInfo 对象，然后向网络接收器发出加载请求。
JSONObject customData = new JSONObject()?
.put("manifestUrl", "MANIFEST_URL")
.put("networkCode", "NETWORK-CODE")
.put("customAssetKey", "CUSTOM_ASSET_KEY")
.put("apiKey", "API_KEY");
MediaInfo mediaInfo = MediaInfo.Builder("CONTENT_ID")
.setContentUrl("BACKUP_STREAM_URL")
.setContentType("CONTENT_STREAM_MIMETYPE")
.setStreamType(MediaInfo.STREAM_TYPE_LIVE)
.setCustomData(customData)
.build();
RemoteMediaClient remoteMediaClient = mCastSession.getRemoteMediaClient();
remoteMediaClient.load(new MediaLoadRequestData.Builder().setMediaInfo(mediaInfo).build());
iOS (Obj-C)
如需在 Cast 网页发送器中配置这些值，请先创建包含所需数据的 GCKMediaInformation 对象，然后向网络接收器发出加载请求。
NSURL url = [NSURL URLWithString:@"BACKUP_STREAM_URL"];
NSDictionary *customData = @{
@"manifestUrl": @"MANIFEST_URL",
@"networkCode": @"NETWORK-CODE",
@"customAssetKey": @"CUSTOM_ASSET_KEY",
@"apiKey": @"API_KEY"};
mediaInfoBuilder.customData = customData;
GCKMediaInformationBuilder *mediaInfoBuilder =
[[GCKMediaInformationBuilder alloc] initWithContentID: @"CONTENT_ID"];
mediaInfoBuilder.contentURL = url;
mediaInfoBuilder.contentType = @"CONTENT_STREAM_MIMETYPE";
mediaInfoBuilder.streamType = GCKMediaStreamTypeLive;
mediaInfoBuilder.customData = customData;
self.mediaInformation = [mediaInfoBuilder build];
GCKRequest *request = [self.sessionManager.currentSession.remoteMediaClient loadMedia:self.mediaInformation];
if (request != nil) {
request.delegate = self;
}
iOS (Swift)
如需在 Cast 网页发送器中配置这些值，请先创建包含所需数据的 GCKMediaInformation 对象，然后向网络接收器发出加载请求。
let url = URL.init(string: "BACKUP_STREAM_URL")
guard let mediaURL = url else {
print("invalid mediaURL")
return
}
let customData = [
"liveConfigID": "MANIFEST_URL",
"networkCode": "NETWORK-CODE",
"customAssetKey": "CUSTOM_ASSET_KEY",
"region": "API_KEY"
]
let mediaInfoBuilder = GCKMediaInformationBuilder.init(contentId: "CONTENT_ID")
mediaInfoBuilder.contentURL = mediaUrl
mediaInfoBuilder.contentType = @"CONTENT_STREAM_MIMETYPE"
mediaInfoBuilder.streamType = GCKMediaStreamType.Live
mediaInfoBuilder.customData = customData
mediaInformation = mediaInfoBuilder.build()
guard let mediaInfo = mediaInformation else {
print("invalid mediaInformation")
return
}
if let request = sessionManager.currentSession?.remoteMediaClient?.loadMedia
(mediaInfo) {
request.delegate = self
}
CAC 工具
如需在 Cast 命令和控制工具中配置这些值，请点击“加载媒体”标签页，然后将自定义加载请求类型设置为 LOAD。然后将文本区域中的 JSON 数据替换为以下 JSON：
{
"media": {
"contentId": "CONTENT_ID",
"contentUrl": "BACKUP_STREAM_URL",
"contentType": ""CONTENT_STREAM_MIMETYPE"",
"streamType": "LIVE",
"customData": {
"liveConfigID": "MANIFEST_URL",
"networkCode": "NETWORK-CODE",
"customAssetKey": "CUSTOM_ASSET_KEY",
"oAuthToken": "API_KEY"
}
}
}
可以将此自定义加载请求发送给接收器，以测试其余步骤。
创建基本 CAF 接收器
创建自定义 Web 接收器，如 CAF SDK 自定义 Web 接收器指南中所述。
接收器的代码应如下所示：
<html>
<head>
<script
src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js">
</script>
</head>
<body>
<cast-media-player></cast-media-player>
<script>
// ...
</script>
</body>
</html>
导入 IMA DAI SDK 并获取播放器管理器
添加脚本代码，将适用于 CAF 的 IMA DAI SDK 导入您的网络接收器（在脚本加载 CAF 之后立即进行）。在脚本标记中，在启动接收器之前，将接收器上下文和播放器管理器存储为常量。
<html>
<head>
<script
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>
初始化 IMA 视频流管理器
初始化 IMA 视频流管理器。
<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>
创建数据流管理器加载拦截器
在媒体项传递给 CAF 之前，请在 LOAD 消息拦截器中创建流式传输请求。
const castContext = cast.framework.CastReceiverContext.getInstance();
const playerManager = castContext.getPlayerManager();
const streamManager = new google.ima.cast.dai.api.StreamManager();
/**
* Creates a livestream request object for a pod serving stream.
* @param {!LoadRequestData} castRequest The request object from the cast sender
* @return {StreamRequest} an IMA stream request
*/
const createStreamRequest = (castRequest) => { /* ... */};
/**
* Initates a DAI stream request for the final stream manifest.
* @param {!LoadRequestData} castRequest The request object from the cast sender
* @return {Promise<LoadRequestData>} a promise that resolves to an updated castRequest, containing the DAI stream manifest
*/
const createDAICastRequest = (castRequest) => {
return streamManager.requestStream(castRequest, createStreamRequest(castRequest))
.then((castRequestWithPodStreamData) => {
console.log('Successfully made DAI stream request.');
// ...
return castRequestWithPodStreamData;
})
.catch((error) => {
console.log('Failed to make DAI stream request.');
// CAF will automatically fallback to the content URL
// that it can read from the castRequest object.
return castRequest;
});
};
playerManager.setMessageInterceptor(
cast.framework.messages.MessageType.LOAD, createDAICastRequest);
castContext.start();
创建数据流请求
完成 createStreamRequest 函数，以根据 CAF 加载请求创建 Pod 服务流。
/**
* Creates a livestream request object for a pod serving stream.
* @param {!LoadRequestData} castRequest The request object from the cast sender
* @return {StreamRequest} an IMA stream request
*/
const createStreamRequest = (castRequest) => {
const streamRequest = new google.ima.cast.dai.api.PodStreamRequest();
const customData = castRequest.media.customData;
streamRequest.customAssetKey = customData.customAssetKey;
streamRequest.networkCode = customData.networkCode;
streamRequest.apiKey = customData.apiKey;
return streamRequest;
};
将内容网址替换为清单网址和视频流 ID
如果数据流请求成功，请使用 streamManager.getStreamId() 检索数据流的 ID 并将其插入 manifestUrl 以替换 [[STREAMID]]。然后，将现有的 contentUrl 替换为新的 manifestUrl，以便 CAF 播放包含拼接的广告连播的直播。
/**
* Initates a DAI stream request for the final stream manifest.
* @param {!LoadRequestData} castRequest The request object from the cast sender
* @return {Promise<LoadRequestData>} a promise that resolves to an updated castRequest, containing the DAI stream manifest
*/
const createDAICastRequest = (castRequest) => {
return streamManager.requestStream(castRequest, createStreamRequest(castRequest))
.then((castRequestWithPodStreamData) => {
console.log('Successfully made DAI stream request.');
const media = castRequestWithPodStreamData.media;
const manifestUrl = media.customData.manifestUrl || "";
if (manifestUrl) {
console.log('Replacing the contentURL with the manifest URL and stream ID');
const streamId = streamManager.getStreamId();
castRequestWithPodStreamData.media.contentUrl = manifestUrl.replace('[[STREAMID]]', streamId);
return castRequestWithPodStreamData;
})
.catch((error) => {
console.log('Failed to make DAI stream request.');
// CAF will automatically fallback to the content URL
// that it can read from the castRequest object.
return castRequest;
});
};
现在，您可以使用 Cast 应用框架和 IMA DAI SDK for CAF 请求和播放 Pod 投放视频流。