在 iOS 中跟踪核心播放 track-core-playback-on-ios

初始跟踪设置

识别用户何时触发播放意图（用户点击“播放”和/或自动播放开启）并创建 MediaObject 实例。

createMediaObjectWithName API

StreamType常量：

MediaType常量：

创建 MediaObject 的一般格式：

ADBMediaObject *mediaObject =
  [ADBMediaHeartbeat createMediaObjectWithName:<MEDIA_NAME>
                                       mediaId:<MEDIA_ID>
                                        length:<MEDIA_LENGTH>
                                    streamType:<STREAM_TYPE>
                                     mediaType: <MEDIA_TYPE>];

附加视频元数据

（可选）通过上下文数据变量将标准和/或自定义视频元数据对象附加到视频跟踪会话。

• 标准视频元数据

  • 在 iOS 中实施标准元数据

  • 视频元数据键
    iOS 元数据键

  • 请在此处查看视频元数据的完整列表：音频和视频参数

  note note
  NOTE
  将标准视频元数据对象附加到媒体对象是可选的。

• 自定义元数据

  为自定义变量创建变量对象，然后使用此视频的数据进行填充。例如：

  code language-none
  NSMutableDictionary *videoMetadata = [[NSMutableDictionary alloc] init]; [videoMetadata setObject:@"false" forKey:@"isUserLoggedIn"]; [videoMetadata setObject:@"Sample TV station" forKey:@"tvStation"];

跟踪开始播放的意图

要开始跟踪媒体会话，请在媒体心跳实例中调用 trackSessionStart。

- (void)onMainVideoLoaded:(NSNotification *)notification {
//    [_mediaHeartbeat trackSessionStart:mediaObject data:nil];
    [_mediaHeartbeat trackSessionStart:mediaObject data:videoMetadata];
}

跟踪播放的实际开始事件

识别视频播放器中的视频播放开始事件（视频的第一帧呈现在屏幕上）并调用 trackPlay：

- (void)onVideoPlay:(NSNotification *)notification {
    [_mediaHeartbeat trackPlay];
}

跟踪播放的结束事件

识别视频播放器中的视频播放结束事件（用户一直观看至内容的结尾）并调用 trackComplete：

- (void)onVideoComplete:(NSNotification *)notification {
    [_mediaHeartbeat trackComplete];
}

跟踪会话的结束事件

识别视频播放器中的视频播放卸载/关闭事件（用户关闭视频和/或视频已结束并卸载）并调用 trackSessionEnd：

- void)onMainVideoUnloaded:(NSNotification *)notification {
    [_mediaHeartbeat trackSessionEnd];
}

跟踪所有可能的暂停方案

识别视频播放器中的视频暂停事件并调用 trackPause：

- (void)onVideoPause:(NSNotification *)notification {
    [_mediaHeartbeat trackPause];
}

暂停方案

识别视频播放器将会暂停的任何方案，并确保正确调用了 trackPause。以下方案均要求应用程序调用 trackPause()：

• 用户在应用程序中明确点击暂停。
• 播放器将其置于“暂停”状态。
• （移动应用程序）- 用户将应用程序放入后台，但您希望应用程序保持会话打开。
• （移动应用程序）- 发生导致应用程序被置于后台运行的任何类型的系统中断。例如，用户接收到一个调用，或者出现来自其他应用程序的弹出窗口，但您希望应用程序将会话保持活动状态，以便用户有机会从中断点继续观看视频。

识别播放器中的视频播放事件和/或视频在暂停后继续播放的事件并调用 trackPlay：

- (void)onVideoPlay:(NSNotification *)notification {
    [_mediaHeartbeat trackPlay];
}