跟踪内容播放

核心播放跟踪涵盖媒体载入、开始、暂停、恢复、完成和会话结束。 虽然不强制,但缓冲和搜寻跟踪也是完整播放实施的核心组件。

播放器事件

播放器事件
操作
媒体加载
创建媒体对象;调用SessionStart
媒体开始
呼叫播放
暂停
调用PauseStart
从暂停中恢复
呼叫播放
媒体结束
调用SessionComplete
媒体中止/卸载
调用Sessionend
缓冲开始
调用Bufferstart
缓冲结束
呼叫播放(恢复)
搜寻开始
调用SeekStart
搜寻结束
调用SeekComplete;然后调用Play

实施步骤

  1. 识别用户何时触发播放(用户点击“播放”或自动播放触发)。 创建具有内容名称、ID、长度、流类型和媒体类型的媒体对象。 有关字段定义,请参阅内容名称内容ID内容长度流类型内容类型
  2. 可选附加元数据 — 标准元数据(节目、季、集等) 和自定义上下文数据变量。 有关标准元数据密钥引用,请参阅节目流派网络
  3. 调用会话开始​以开始跟踪会话。 这会加载数据和元数据,并开始开始时间QoS测量。 SessionStart跟踪要播放的​意图,而不是第一帧。
  4. 当第一帧内容在屏幕上呈现时,调用播放
  5. 播放器暂停时,调用暂停开始。 恢复播放时再次调用播放。 没有单独的恢复事件。
  6. 当查看器到达内容结尾时,调用会话完成
  7. 当播放器卸载或查看器放弃内容而未到达结尾时,调用会话结束。 SessionEnd立即关闭会话;之后将无法跟踪其他事件。
IMPORTANT
SessionEnd 标记跟踪会话的结尾。 如果会话成功观看至结束,请在SessionEnd之前调用SessionComplete。 在SessionEnd之后将忽略任何其他跟踪调用,新会话的SessionStart除外。

核心播放

以下示例显示了一个完整的会话流 — 从会话开始到内容完成和会话结束。

有关平台实现的详细信息,请参阅会话开始播放暂停开始会话完成会话结束

缓冲

缓冲开始表示播放器正在等待数据。 在BufferStart(基于XDM的API)之后发送播放事件时推断缓冲结束。 在Mobile SDK上,还应显式调用BufferComplete。

有关实现详细信息,请参阅缓冲开始

搜寻

搜寻开始表示查看器正在推移。 搜寻结束之后,播放,可继续播放内容。

有关实施详细信息,请参阅暂停开始 (搜寻开始)和播放 (搜寻结束)。

处理应用程序中断

媒体应用程序中的播放过程可能会因为多种原因出现中断 — 用户按下暂停,应用程序进入后台,接到电话。 无论原因如何,跟踪指令都相同:

  1. 当应用程序中断(进入后台、媒体暂停等)时,调用​PauseStart
  2. 当应用程序返回前台和/或媒体重新开始播放时,调用​播放
NOTE
当应用程序从后台返回时,请勿调用SessionStart。 调用SessionStart会导致截至该时间为止的播放不计入总播放时间,并且之前的进度标记、区段和章节边界将丢失。

暂停的会话应何时结束? 如果应用程序不允许后台播放,请立即调用PauseStart ,然后在后台运行大约一分钟后调用SessionEnd 。 应用程序无法从后台继续发送暂停ping,无限期地保持会话打开状态会带来不良体验。 如果应用程序支持后台播放(音频应用程序、视频播客应用程序),请在后台时继续发送ping。

在较长的后台时段后重新启动:​如果应用程序在后台运行的时间足够长,导致会话过期(30分钟不活动),请调用SessionEnd以完全关闭任何延迟的会话,然后在查看器返回时调用SessionStart以开始一个新会话。

恢复不活动的会话

如果未在10分钟内收到任何事件,或者播放头在30分钟内未移动,则会话将自动过期。 如果用户在会话过期后返回,请再次调用SessionStart以打开新会话。

跨设备恢复(跨设备切换):​当查看者在设备之间传输播放内容(例如,从手机到电视的播放)时,请使用恢复标志在Analytics报表中将会话拼合在一起:

  1. 在​ 源设备 ​上,当查看器启动转换时,调用SessionEnd。 不调用SessionComplete — 内容未完成。
  2. 在​ 目标设备 ​上,调用SessionStart并将恢复标志设置为true,并从源设备传递相同的内容元数据和播放头位置。

设置恢复标志会导致Analytics在移交的第二阶段递增内容恢复,而不是媒体开始

手动恢复先前关闭的会话:​如果应用程序存储用户数据并可以恢复先前关闭的会话,请在会话开始时设置恢复标志。 请参阅会话开始以了解所有平台上的实施详细信息。

recommendation-more-help
media-analytics-help