在 TV 输入服务中使用时移 API,让用户能够在服务频道中暂停、快退和快进直播节目。如果您的应用支持时移,用户可以灵活地选择观看内容的方式:
- 用户可以在处理短期中断时暂停节目,因此不会错过关键时刻。
- 用户可以快进播放他们看过的内容或不感兴趣的内容。
- 用户可以快退并回看节目内容中最喜爱的情节。
时移使用简短、临时、录制的节目数据片段来实现播放直播节目的功能。用户无法在当前播放会话之外播放这些时移录制内容。这意味着,当他们切换到其他频道时,无法使用时移来暂停某个节目以便在第二天观看,也无法暂停某个节目以便稍后观看。
如果您想让用户能够录制节目内容以在当前播放会话之外观看,请使用电视录制 API。
添加时移支持
如需向 TV 输入服务添加时移支持,您需要在 TvInputService.Session
类中实现时移 API,在应用中处理时移录制内容的录制和播放,并通知系统您的输入服务提供时移支持。
您实现的 TvInputService.Session
方法如下所示:
onTimeShiftGetCurrentPosition()
:系统调用此方法来获取当前播放位置(以毫秒为单位)。如需了解详情,请参阅跟踪播放时间部分。onTimeShiftGetStartPosition()
:系统通过调用此方法来获取当前时移录制内容的起始位置(以毫秒为单位)。如需了解详情,请参阅跟踪播放时间部分。onTimeShiftPause()
:在用户暂停播放时调用。onTimeShiftResume()
:在用户继续播放时调用。onTimeShiftSeekTo(long)
:当系统需要寻找新的时间位置时调用。通常,新位置介于起始位置和当前位置之间。onTimeShiftSetPlaybackParams(PlaybackParams)
:系统调用此方法来为当前会话提供播放参数,例如播放速度。如需了解详情,请参阅支持播放参数部分。
如需详细了解如何通知系统您的输入服务支持时移,请参阅将时移状态告知系统部分。
如果您使用 TIF 随播库实现 TvInputService.Session
类,会自动获得使用 ExoPlayer 的时移实现。您可以使用此实现,也可以替换 BaseTvInputService.Session
中的时移 API 方法,并提供自己的实现。如需详细了解如何使用 TIF 随播内容库,请参阅使用 TIF 随播内容库创建 TV 输入服务。
在会话开始时录制内容
用户可以通过访问频道的播放控件来暂停、快退和快进节目内容,方法是在观看内容时按选择,然后导航到播放控件,或者使用远程设备上的专用播放控件。
由于用户在观看节目内容时可以随时使用时移,因此您的 TV 输入服务必须在用户调到您的 onTune()
实现中的某个频道后立即开始录制时移内容。您还需要通过调用 notifyTimeShiftStatusChanged(int)
来告知系统您能够录制,如将时移状态告知系统部分中所述。
管理录制内容存储
TV 输入服务负责将时移录制内容存储在应用的专用应用存储空间中,并在系统调用时移方法(例如 onTimeShiftResume()
)时播放内容。如果您的内容已存储在云端,并且您的应用可以管理云端的时移录制内容,则您可以使用云端存储空间,而不是应用存储空间。
如果您的内容使用受保护的内容,您的 TV 输入服务将负责对录制的内容进行适当的加密,并在播放期间对内容进行解密。
由于录制的视频内容可能需要大量的存储空间,因此您需要在会话播放期间妥善管理录制的内容。如果播放会话时间超过您可以录制和存储时移的时间,请调整时移录制内容以保留当前缓冲区,但要确保捕获当前时间。例如,如果用户已播放内容 31 分钟,而您的时移录制内容大小为 30 分钟,则请调整录制内容和开始时间,以包含从第 1 分钟到第 31 分钟的内容。
如果您的 TV 输入服务因缺少存储空间而无法支持时移,您必须通知系统。如需详细了解如何将时移支持限制告知系统,请参阅将时移状态告知系统部分。
当用户切换到其他频道或结束播放会话时,删除录制的时移数据。
将时移状态告知系统
如果您的 TV 输入服务支持时移,请在用户调到某个频道时,在您的 onTune()
实现中调用 notifyTimeShiftStatusChanged(TvInputManager.TIME_SHIFT_STATUS_AVAILABLE)
。
如需在输入服务的任何时移功能发生更改时通知系统,请使用 notifyTimeShiftStatusChanged(int)
。例如,如果您的 TV 输入服务因存储空间限制或其他原因而无法支持时移,请调用 notifyTimeShiftStatusChanged(TvInputManager.TIME_SHIFT_STATUS_UNAVAILABLE)
。
如果您的 TV 输入服务根本不支持时移,请在创建播放会话时调用 notifyTimeShiftStatusChanged(TvInputManager.TIME_SHIFT_STATUS_UNSUPPORTED)
。系统会将任何从不调用 notifyTimeShiftStatusChanged()
的输入服务视为不支持时移的输入服务。这包括使用 API 级别 22 及更早版本的输入服务。
跟踪播放时间
时移录制内容的起始位置是用户可以跳转到的最早绝对时间位置(以从公元纪年开始计算的毫秒数表示)。这通常是在调用 onTune()
后视频播放开始的时间。但是,当用户观看的内容量超出应用可以录制的范围时,您需要开始录制新的时移片段,并相应地更新开始时间。
时移录制内容的当前位置是当前播放位置(以从公元纪年开始计算的毫秒数表示)。在播放过程中,此位置会不断变化。通常,您可以使用播放引擎来确定此值,如以下示例所示:
Kotlin
override fun onTimeShiftGetCurrentPosition(): Long = tvPlayer?.run { currentProgram?.let { program -> currentPosition + program.startTimeUtcMillis } } ?: TvInputManager.TIME_SHIFT_INVALID_TIME
Java
@Override public long onTimeShiftGetCurrentPosition() { if (getTvPlayer() != null && currentProgram != null) { return getTvPlayer().getCurrentPosition() + currentProgram.getStartTimeUtcMillis(); } return TvInputManager.TIME_SHIFT_INVALID_TIME; }
确保您在系统调用 onTimeShiftGetStartPosition()
时提供的开始时间绝不会超过您在 onTimeShiftGetCurrentPosition()
中提供的当前时间位置。系统会使用这些调用来更新播放控件界面中的时移时长。
支持播放参数
如需在时移过程中更改播放速度,系统需要使用播放参数。例如,如果用户决定快退当前播放,系统会向您的应用传递采用负播放速度的新播放参数。时移还支持几种不同级别的快退或快进播放速度(2 倍或 3 倍)。
系统会使用包含当前会话参数的 PlaybackParams
对象调用您的 onTimeShiftSetPlaybackParams(PlaybackParams)
方法。您可以根据这些信息对您的媒体播放引擎进行适当配置。
如果您的播放引擎不支持某个参数,请尽可能模拟预期的行为。例如,如果您的播放引擎不支持两倍速度,请在您的播放引擎上使用重复跳转操作来实现大约两倍的播放速度。
参数设置完毕后,除非用户发出需要其他参数的播放命令或切换到新频道,否则请勿更改这些设置。