createMediaSession
createMediaSession命令是Web SDK streamingMedia组件的一部分。 您可以使用此组件收集与网站上的媒体会话相关的数据。 请参阅streamingMedia 文档以了解如何配置此组件。
收集的数据可以包括有关媒体回放、暂停、完成和其他相关事件的信息。 收集数据后，您可以将此数据发送到Adobe Analytics for Streaming Media以聚合量度。 此功能为跟踪和了解您网站上的媒体消费行为提供了全面的解决方案。
您可以通过两种方式在Web SDK中创建媒体会话：
- 自动跟踪的媒体会话允许Web SDK管理向Adobe Analytics for Streaming Media发送媒体Ping事件。 这些ping的频率由streamingMedia组件的配置设置决定。
- 手动跟踪的媒体会话让您能够更好地控制向Adobe Analytics for Streaming Media发送会话Ping事件。 此外，您还可以为媒体会话存储
sessionID。
创建自动跟踪的媒体会话 automatic
要自动开始跟踪媒体会话，请使用下述选项调用createMediaSession方法：
alloy("createMediaSession", {
playerId: "movie-test",
getPlayerDetails: () => {
return {
playhead: document.getElementById("movie-test").currentTime,
qoeDataDetails: {
bitrate: 1000,
startupTime: 1000,
fps: 30,
droppedFrames: 10
}
};
},
xdm: {
eventType: "media.sessionStart",
mediaCollection: {
sessionDetails: {
...
}
}
}
});
属性
类型
必需
描述
playerId字符串
是
播放器ID，表示媒体会话的唯一标识符。
getPlayerDetails函数
是
返回播放器详细信息的函数。 此回调函数将在所提供的
playerId的每个媒体事件之前由Web SDK调用。xdm.eventType对象
否
媒体事件类型。 如果未提供，此字段将自动设置为
media.sessionStart。创建手动跟踪的媒体会话 manual
要开始手动跟踪媒体会话，请使用如下所述的选项调用createMediaSession方法：
const sessionPromise = alloy("createMediaSession", {
xdm: {
eventType: "media.sessionStart",
mediaCollection: {
playhead: 0,
sessionDetails: {
...
},
qoeDataDetails: {
bitrate: 1000,
startupTime: 1000,
fps: 30,
droppedFrames: 10
}
}
}
});
属性
类型
已请求
描述
xdm.eventType对象
否
媒体事件类型。 如果未提供，则它自动设置为
media.sessionStart。xdm.mediaCollection.playhead整数
是
当前播放头。
使用Web SDK标记扩展创建媒体会话
与此命令等效的Web SDK标记扩展是“Session start”操作中的Send media event事件类型。
recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1