实时主内容 live-main-content

方案 scenario

在此方案中，有一个实时资源，在加入实时流后 40 秒内不播放任何广告。

参数 parameters

您在 Adobe Analytics 内容开始调用中看到的很多值，同样也会在心率内容开始调用中看到。您还会看到许多其他参数，Adobe 使用这些参数填充 Adobe Analytics 中的各种媒体报表。我们不会在这里涵盖所有这些变量，而是只列出一些非常重要的变量。

心率内容开始

内容心率 content-heartbeats

在媒体播放期间，有一个计时器将会每 10 秒发送一次主内容的一个或多个心率（或 ping），每 1 秒发送一次广告的一个或多个心率（或 ping）。这些心率将包含有关播放、广告、缓冲和许多其他内容的信息。每个心跳的确切内容不在本文档涵盖的范围之内，验证的关键内容是在持续播放期间始终触发心跳。

在内容心跳中，查找一些特定的内容：

心率内容结束 heartbeat-content-complete

由于实时流从不结束，因此这种情况下不会有结束调用。

播放头值设置

对于 LIVE 流，您需要将播放头值设置为自当天 UTC 午夜开始的秒数，以便在报告中，分析人员可以确定用户在 24 小时视图内何时加入和离开 LIVE 流。

开始时

对于 LIVE 媒体，当用户开始播放流时，您需要将 l:event:playhead 设置为自当天 UTC 午夜以来的秒数。这与 VOD 相反，在 VOD 中，您需要将播放头设置为“0”。请注意：使用进度标记时，需要内容持续时间，并且播放头需要更新为从媒体项目开始的秒数，从 0 开始。

例如，假设实时流事件从午夜开始，并且持续 24 小时（a.media.length=86400；l:asset:length=86400）。然后，再假设某位用户在中午 12:00 开始播放该实时流。在这种场景下，您应该将 l:event:playhead 设置为 43200（自当天 UTC 午夜起 12 小时，以秒为单位）。

暂停时

当用户暂停播放时，必须应用在播放开始时所应用的相同“实时播放头”逻辑。当用户返回播放 LIVE 流时，您必须根据自午夜 UTC 以来的新秒数设置 l:event:playhead 值，不是 ​到用户暂停 LIVE 流的点。

示例代码 sample-code

Android

以下是预期的 API 调用顺序：

// Set up mediaObject
MediaObject mediaInfo = MediaHeartbeat.createMediaObject(
  Configuration.MEDIA_NAME,
  Configuration.MEDIA_ID,
  Configuration.MEDIA_LENGTH,
  MediaHeartbeat.StreamType.LIVE
);

HashMap<String, String> mediaMetadata = new HashMap<String, String>();
mediaMetadata.put(CUSTOM_VAL_1, CUSTOM_KEY_1);
mediaMetadata.put(CUSTOM_VAL_2, CUSTOM_KEY_2);

// 1. Call trackSessionStart() when the user clicks Play or if autoplay is used,
//    i.e., there is an intent to start playback.
_mediaHeartbeat.trackSessionStart(mediaInfo, mediaMetadata);

......
......

// 2. Call trackPlay() when the playback actually starts, i.e., when the first
//    frame of main content is rendered on the screen.
_mediaHeartbeat.trackPlay();

.......
.......

// 3. Call trackSessionEnd() when user ends the playback session.
//    Since the user does not watch live media to completion, there
//    is no need to call trackComplete().
_mediaHeartbeat.trackSessionEnd();
.......
.......

iOS

以下是预期的 API 调用顺序：

// Set up mediaObject
ADBMediaObject *mediaObject =
[ADBMediaHeartbeat createMediaObjectWithName:MEDIA_NAME
                   length:MEDIA_LENGTH
                   streamType:ADBMediaHeartbeatStreamTypeLIVE];

NSMutableDictionary *mediaContextData = [[NSMutableDictionary alloc] init];
[mediaContextData setObject:CUSTOM_VAL_1 forKey:CUSTOM_KEY_1];
[mediaContextData setObject:CUSTOM_VAL_2 forKey:CUSTOM_KEY_2];

// 1. Call trackSessionStart when the user clicks Play or if autoplay is used,
//    i.e., there is an intent to start playback.
[_mediaHeartbeat trackSessionStart:mediaObject data:mediaContextData];
......
......

// 2. Call trackPlay when the playback actually starts, i.e., when the first
//    frame of the main content is rendered on the screen.
[_mediaHeartbeat trackPlay];
.......
.......

// 3. Call trackSessionEnd when user ends the playback session. Since the user
//    does not watch live media to completion, there is no need to call
//    trackComplete.
[_mediaHeartbeat trackSessionEnd];
........
........

JavaScript

以下是预期的 API 调用顺序：

// Set up mediaObject
var mediaInfo =
MediaHeartbeat.createMediaObject(Configuration.MEDIA_NAME,
                                 Configuration.MEDIA_ID,
                                 Configuration.MEDIA_LENGTH,
                                 MediaHeartbeat.StreamType.VOD);

var mediaMetadata = {
  CUSTOM_KEY_1 : CUSTOM_VAL_1,
  CUSTOM_KEY_2 : CUSTOM_VAL_2,
  CUSTOM_KEY_3 : CUSTOM_VAL_3
};

// 1. Call trackSessionStart() when Play is clicked or if autoplay
//    is used, i.e., there's an intent to start playback.
this._mediaHeartbeat.trackSessionStart(mediaInfo, mediaMetadata);

......
......

// 2. Call trackPlay() when the playback actually starts, i.e., when the
//    first frame of media is rendered on the screen.
this._mediaHeartbeat.trackPlay();

.......
.......

// 3. Call trackSessionEnd() when user ends the playback session.
//    Since user does not watch live media to completion, there is
//    no need to call trackComplete().
this._mediaHeartbeat.trackSessionEnd();

........
........