createMediaSession
createMediaSession命令是Web SDK streamingMedia元件的一部分。 您可以使用此元件來收集與網站上媒體工作階段相關的資料。 請參閱streamingMedia 檔案以瞭解如何設定此元件。
收集的資料可包括關於媒體播放、暫停、完成和其他相關事件的資訊。 收集之後，您可以將此資料傳送至適用於串流媒體的Adobe Analytics，以彙總量度。 此功能提供全方位的解決方案，可追蹤及瞭解您網站上的媒體使用行為。
您可以在Web SDK中以兩種方式建立媒體工作階段：
- 自動追蹤的媒體工作階段可讓Web SDK管理將媒體Ping事件傳送至適用於串流媒體的Adobe Analytics。 這些Ping的頻率是由streamingMedia元件的組態設定所決定。
- 手動追蹤的媒體工作階段可讓您更能掌控將工作階段Ping事件傳送至適用於串流媒體的Adobe Analytics。 此外，您也可以儲存媒體工作階段的
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函數
是
傳回播放器詳細資料的函式。 此回呼函式將會由Web SDK在提供的
playerId的每個媒體事件之前呼叫。xdm.eventType物件
無
媒體事件型別。 若未提供，此專案會自動設為
media.sessionStart。xdm.mediaCollection.sessionDetails物件
是
工作階段詳細資料物件。
sessionDetails物件應包含工作階段詳細資料屬性。 如需詳細資訊，請參閱媒體收集結構描述檔案。建立手動追蹤的媒體工作階段 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.sessionDetails物件
是
工作階段詳細資料物件。
sessionDetails物件應包含工作階段詳細資料屬性。 如需詳細資訊，請參閱媒體收集結構描述檔案。xdm.mediaCollection.playhead整數
是
目前的播放點。
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636