Adobe Medium Analytics for Audio and Video擴充功能概觀

建立 MediaHeartbeat 例項：  window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat.getInstance

參數： ​有效的委派物件會顯示以下函數。

傳回值： ​一種 Promise，使用 MediaHeartbeat 例項解析，或拒絕並提供錯誤訊息。

存取 MediaHeartbeat 常數：  window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat

這會公開 MediaHeartbeat 類別中的所有常數和靜態方法。

範例播放器可從這裡取得：MA 範例播放器。範例播放器可作為參考，以示範如何使用 MA 擴充功能直接從網路應用程式支援 Media Analytics。

建立 MediaHeartbeat 追蹤器例項，如下所示：

var MediaHeartbeat = window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat;

var delegate = {
    getCurrentPlaybackTime: this._getCurrentPlaybackTime.bind(this),
    getQoSObject: this._getQoSObject.bind(this),
};

var config = {
    playerName: "Custom Player",
    ovp: "Custom OVP",
    channel: "Custom Channel"
};

var self = this;
MediaHeartbeat.getInstance(delegate, config).then(function(instance) {
    self._mediaHeartbeat = instance;
    // Do Tracking using the MediaHeartbeat instance.
}).catch(function(err){
    // Getting MediaHeartbeat instance failed.
});

建立 MediaHeartbeat 例項：get-instance共用模組

參數：

• 有效的委派物件會顯示以下函數：

  table 0-row-2 1-row-2 2-row-2 1-align-left 2-align-left 4-align-left 5-align-left 7-align-left 8-align-left
  方法	說明
  getQoSObject()	傳回包含目前 QoS 資訊的 MediaObject 例項。將在播放工作階段期間呼叫此方法多次。播放器實作必須一律傳回最新的可用 QoS 資料。
  getCurrentPlaybackTime()	傳回播放點的目前位置。對於 VOD 追蹤，該值是從媒體項目的開頭開始以秒為單位指定的。對於 LIVE/LIVE 追蹤，該值是從節目的開頭開始以秒為單位指定的。

• 選用的設定物件會顯示這些屬性：

  table 0-row-3 1-row-3 2-row-3 3-row-3 1-align-left 2-align-left 3-align-left 5-align-left 6-align-left 7-align-left 9-align-left 10-align-left 11-align-left 13-align-left 14-align-left 15-align-left
  屬性	說明	必填
  Online Video Provider	線上視訊平台的名稱，透過該平台來分送內容。	否。如果存在，則會在擴充功能設定期間覆寫定義的值。
  Player Name	使用的媒體播放器名稱 (例如：「AVPlayer」、「HTML5 播放器」、「我的自訂視訊播放器」)	否。如果存在，則會在擴充功能設定期間覆寫定義的值。
  Channel	管道名稱屬性	否。如果存在，則會在擴充功能設定期間覆寫定義的值。

傳回值： ​一種 Promise，使用 MediaHeartbeat 例項解析，或拒絕並提供錯誤訊息。

存取 MediaHeartbeat 常數：media-heartbeat共用模組

此模組會公開此類別中所有的常數和靜態方法：https://adobe-marketing-cloud.github.io/media-sdks/reference/javascript/MediaHeartbeat.html。

建立 MediaHeartbeat 追蹤器例項，如下所示：

var getMediaHeartbeatInstance =
  turbine.getSharedModule('adobe-video-analytics', 'get-instance');

var MediaHeartbeat =
  turbine.getSharedModule('adobe-video-analytics', 'media-heartbeat');
  ...

var delegate = {
    getCurrentPlaybackTime: this._getCurrentPlaybackTime.bind(this),
    getQoSObject: this._getQoSObject.bind(this),
}

var config = {
    playerName: "Custom Player",
    ovp: "Custom OVP",
    channel: "Custom Channel"
}
...

var self = this;
getMediaHeartbeatInstance(delegate, config).then(function(instance) {
    self._mediaHeartbeat = instance;
    ...
    // Do Tracking using the MediaHeartbeat instance.
}).catch(function(err){
    // Getting MediaHeartbeat instance failed.
});

...

使用 Media Heartbeat 例項，並按照 Media SDK JS 文件和 JS API 文件 中的說明來實作媒體追蹤功能。