TvInputService.RecordingSession

TvInputService.RecordingSession

TvInputService.RecordingSession (Context context)

创建一个新的RecordingSession。

notifyError

void notifyError (int error)

通知应用程序存在错误，并且此记录会话不再能够开始或继续记录。 它可以在创建记录会话之后随时调用，直到onRelease() 。

通过onError(int)收到错误代码后，应用程序可能会释放当前会话。 在调用此方法之前，如果部分记录但仍可播放的程序可用，则会话可能会调用notifyRecordingStopped(Uri) 。

notifyRecordingStopped

void notifyRecordingStopped (Uri recordedProgramUri)

通知应用程序此记录会话已停止记录，并在 TvContract.RecordedPrograms表中创建一个描述新录制程序的新数据条目。

记录会话必须调用此方法以响应onStopRecording() 。 如果在发生错误时可以使用部分录制的节目，则甚至可以在接到对onStopRecording()的呼叫之前进行会话。

notifyTuned

void notifyTuned (Uri channelUri)

通知应用程序此录制会话已调整到给定频道并准备开始录制。

在收到对onTune(Uri)的呼叫后，会话期望调谐到传递的频道并调用此方法以表明它现在可用于立即录制。 当onStartRecording(Uri) ，记录必须以最小的延迟开始。

onAppPrivateCommand

void onAppPrivateCommand (String action, 
                Bundle data)

处理从应用程序发送到电视输入的私人命令。 这可以用于提供特定于域的功能，这些功能仅在某些电视输入和它们的客户端之间是已知的。

onRelease

void onRelease ()

当应用程序请求释放此记录会话持有的所有资源时调用。

onStartRecording

void onStartRecording (Uri programUri)

当应用程序请求启动电视节目录制时调用。 此方法被调用时，必须立即开始记录。

应用程序可以为电视节目提供URI，以填写TvContract.RecordedPrograms表中的节目特定数据字段。 非空programUri意味着开始的记录应该是特定的程序，而空programUri不会强加这样的要求，并且记录可以跨越多个电视节目。 无论哪种情况，应用程序都必须致电stopRecording()停止录制。

如果启动请求不能满足，会话必须调用 notifyError(int) 。

onStopRecording

void onStopRecording ()

当应用程序请求停止电视节目录制时调用。 此方法被调用时，录制必须立即停止。

会话必须在TvContract.RecordedPrograms表中创建一个描述新录制节目的新数据条目，并使用notifyRecordingStopped(Uri)目的URI调用notifyRecordingStopped(Uri) 。 如果停止请求不能满足，会话必须调用notifyError(int) 。

onTune

void onTune (Uri channelUri, 
                Bundle params)

当应用程序请求调谐到给定频道以进行电视节目录制时调用。 覆盖此方法是为了处理特定于特定电视输入和其客户端之间的特定于域的功能。

应用程序可能会在开始或停止录制之前调用此方法，但在录制过程中可能不会。 默认实现调用onTune(Uri) 。

如果调谐请求得到满足，会话必须调用 notifyTuned(Uri) ，否则 notifyError(int) 。

onTune

void onTune (Uri channelUri)

当应用程序请求调谐到给定频道以进行电视节目录制时调用。

应用程序可能会在开始或停止录制之前调用此方法，但在录制过程中可能不会。

会话必须调用 notifyTuned(Uri)如果调谐请求被满足，或者 notifyError(int)否则。