Adobe Experience Platform Launch 已更名为 Experience Platform 中的一套数据收集技术。因此,产品文档中的术语有一些改动。有关术语更改的综合参考,请参阅以下文档。
在独立 Media SDK 中,您可以在应用程序中配置跟踪,并在创建跟踪器时将其传递给 SDK。
MediaHeartbeatConfig config = new MediaHeartbeatConfig();
config.trackingServer = "namespace.hb.omtrdc.net";
config.channel = "sample-channel";
config.appVersion = "v2.0.0";
config.ovp = "video-provider";
config.playerName = "native-player";
config.ssl = true;
config.debugLogging = true;
MediaHeartbeat tracker = new MediaHeartbeat(... , config);
在独立 Media SDK 中,您可以手动创建 MediaHeartbeatConfig
对象并配置跟踪参数。实施公开 getQoSObject()
和 getCurrentPlaybackTime()functions.
的委派接口。创建用于跟踪的 MediaHeartbeat
实例。
MediaHeartbeatConfig config = new MediaHeartbeatConfig();
config.trackingServer = "namespace.hb.omtrdc.net";
config.channel = "sample-channel";
config.appVersion = "v2.0";
config.ovp = "video-provider";
config.playerName = "native-player";
config.ssl = true;
config.debugLogging = true;
MediaHeartbeatDelegate delegate = new MediaHeartbeatDelegate() {
@Override
public MediaObject getQoSObject() {
// When called should return the latest qos values.
return MediaHeartbeat.createQoSObject(<bitrate>,
<startupTime>,
<fps>,
<droppedFrames>);
}
@Override
public Double getCurrentPlaybackTime() {
// When called should return the current player time in seconds.
return <currentPlaybackTime>;
}
MediaHeartbeat tracker = new MediaHeartbeat(delegate, config);
}
在创建跟踪器之前,应先使用移动核心注册媒体扩展和从属扩展。
// Register the extension once during app launch
try {
// Media needs Identity and Analytics extension
// to function properly
Identity.registerExtension();
Analytics.registerExtension();
// Initialize media extension.
Media.registerExtension();
MobileCore.start(new AdobeCallback () {
@Override
public void call(Object o) {
// Launch mobile property to pick extension settings.
MobileCore.configureWithAppID("LAUNCH_MOBILE_PROPERTY");
}
});
} catch (InvalidInitException ex) {
...
}
注册媒体扩展后,请使用以下 API 创建跟踪器。
该跟踪器会自动从已配置的 Launch 属性中选取配置。
Media.createTracker(new AdobeCallback<MediaTracker>() {
@Override
public void call(MediaTracker tracker) {
// Use the instance for tracking media.
}
});
在独立 Media SDK 中,在创建跟踪器期间传递实施 MediaHeartbeartDelegate
接口的委派对象。每当跟踪器调用 getQoSObject()
和 getCurrentPlaybackTime()
接口方法时,该实施应返回最新的 QoE 和播放头。
该实施应通过调用跟踪器公开的 updateCurrentPlayhead
方法来更新当前播放器的播放头。要进行准确跟踪,您应至少每秒调用一次此方法。
该实施应通过调用跟踪器公开的 updateQoEObject
方法来更新 QoE 信息。我们希望每当质量量度发生变化都要调用此方法。
标准媒体元数据:
MediaObject mediaInfo =
MediaHeartbeat.createMediaObject("media-name",
"media-id",
60D,
MediaHeartbeat.StreamType.VOD,
MediaHeartbeat.MediaType.Video);
// Standard metadata keys provided by adobe.
Map <String, String> standardVideoMetadata =
new HashMap<String, String>();
standardVideoMetadata.put(MediaHeartbeat.VideoMetadataKeys.EPISODE,
"Sample Episode");
standardVideoMetadata.put(MediaHeartbeat.VideoMetadataKeys.SHOW,
"Sample Show");
standardVideoMetadata.put(MediaHeartbeat.VideoMetadataKeys.SEASON,
"Sample Season");
mediaInfo.setValue(MediaHeartbeat.MediaObjectKey.StandardMediaMetadata,
standardVideoMetadata);
// Custom metadata keys
HashMap<String, String> mediaMetadata = new HashMap<String, String>();
mediaMetadata.put("isUserLoggedIn", "false");
mediaMetadata.put("tvStation", "Sample TV Station");
tracker.trackSessionStart(mediaInfo, mediaMetadata);
标准广告元数据:
MediaObject adInfo =
MediaHeartbeat.createAdObject("ad-name",
"ad-id",
1L,
15D);
// Standard metadata keys provided by adobe.
Map <String, String> standardAdMetadata =
new HashMap<String, String>();
standardAdMetadata.put(MediaHeartbeat.AdMetadataKeys.ADVERTISER,
"Sample Advertiser");
standardAdMetadata.put(MediaHeartbeat.AdMetadataKeys.CAMPAIGN_ID,
"Sample Campaign");
adInfo.setValue(MediaHeartbeat.MediaObjectKey.StandardAdMetadata,
standardAdMetadata);
HashMap<String, String> adMetadata =
new HashMap<String, String>();
adMetadata.put("affiliate",
"Sample affiliate");
tracker.trackEvent(MediaHeartbeat.Event.AdStart,
adObject,
adMetadata);
标准媒体元数据:
HashMap<String, Object> mediaObject =
Media.createMediaObject("media-name",
"media-id",
60D,
MediaConstants.StreamType.VOD,
Media.MediaType.Video);
HashMap<String, String> mediaMetadata =
new HashMap<String, String>();
// Standard metadata keys provided by adobe.
mediaMetadata.put(MediaConstants.VideoMetadataKeys.EPISODE,
"Sample Episode");
mediaMetadata.put(MediaConstants.VideoMetadataKeys.SHOW,
"Sample Show");
// Custom metadata keys
mediaMetadata.put("isUserLoggedIn", "false");
mediaMetadata.put("tvStation", "Sample TV Station");
tracker.trackSessionStart(mediaInfo, mediaMetadata);
标准广告元数据:
HashMap<String, Object> adObject =
Media.createAdObject("ad-name",
"ad-id",
1L,
15D);
HashMap<String, String> adMetadata =
new HashMap<String, String>();
// Standard metadata keys provided by adobe.
adMetadata.put(MediaConstants.AdMetadataKeys.ADVERTISER,
"Sample Advertiser");
adMetadata.put(MediaConstants.AdMetadataKeys.CAMPAIGN_ID,
"Sample Campaign");
// Custom metadata keys
adMetadata.put("affiliate",
"Sample affiliate");
_tracker.trackEvent(Media.Event.AdStart,
adObject,
adMetadata);