このページは Cloud Translation API によって翻訳されました。

タイムシフトをサポートする

TV 入力サービスでタイムシフト API を使用して、ユーザーが一時停止、巻き戻し、再生を行えるようにするライブ番組を早送りできます。アプリがタイムシフトにより、ユーザーはコンテンツを柔軟に視聴できるようになります。

短時間の中断を処理している間にプログラムを一時停止できるため、重要な瞬間を見逃すことがありません。
すでに見たことのあるコンテンツや関心がないかもしれません
番組コンテンツを好きなタイミングまで巻き戻して再視聴する

図 1. タイムシフトに使用される Android TV の再生コントロール

タイムシフトは、番組データの短時間かつ一時的な録画セグメントを使用して、ライブ番組を再生する機能を実装します。これらのタイムシフトは再生できません録音、録音、録画、録音を行なうこともできます。つまり、番組を一時停止して翌日に見るためのタイムシフトや、別のチャンネルに切り替えたときに表示されます。

必要に応じてテレビ録画の API を使用するユーザーが番組コンテンツを録画して、現在の再生以外で視聴できるようにしますあります。

タイムシフトのサポートを追加する

TV 入力サービスにタイムシフトのサポートを追加するには、 TvInputService.Session クラスのタイムシフト API アプリでタイムシフト録画の録画と再生を処理し、タイムシフトをサポートする入力サービスが提供するシステム。

実装する TvInputService.Session メソッドは次のとおりです。次のとおりです。

onTimeShiftGetCurrentPosition(): 取得して現在のバージョンを再生位置（ミリ秒単位）。詳しくは、再生時間を追跡する。
onTimeShiftGetStartPosition(): 開始メッセージを取得するためにシステムによって現在のタイムシフト録画の位置（ミリ秒単位）。詳しくは再生時間をトラッキングするをご覧ください。
onTimeShiftPause(): ユーザーが再生を一時停止したときに呼び出されます。
onTimeShiftResume(): ユーザーが再生を再開したときに呼び出されます。
onTimeShiftSeekTo(long): システムがリクエストをシークする必要がある場合に新しい時間の位置です通常、新しい位置は開始位置と現在の位置です
onTimeShiftSetPlaybackParams(PlaybackParams): システムによって呼び出されるを使用して、現在のセッションの再生速度などの再生パラメータを提供します。詳しくは、再生パラメータをサポートするセクション。

入力サービスがサポートしていることをシステムに通知する方法について詳しくは、タイムシフトについては、タイムシフトのステータスをシステムに通知する。

TIF Companion Library を使用して TvInputService.Session クラスを ExoPlayer を使用するタイムシフトの実装。こちらのタイムシフト API メソッドを BaseTvInputService.Session - 独自に指定説明します。TIF Companion Library の使用方法について詳しくは、 TIF Companion ライブラリをご覧ください。

セッション開始時にコンテンツを録画する

ユーザーは、選択するか、選択ボタンを同時に押すか、再生コントロールに移動するか専用の再生コントロールを使用できます。

ユーザーは番組コンテンツやテレビの視聴中にタイムシフトをいつでも使用するタイムシフトコンテンツの録画は、あなたのチャンネルの onTune() 説明します。さらに、次の番号に電話をかけて、録音できることをシステムに通知します。 notifyTimeShiftStatusChanged(int), 記載されているタイムシフトのステータスをシステムに通知する。

録画コンテンツストレージを管理する

テレビ入力サービスは、タイムシフトの録画をアプリがローカルに保持し、システムにより呼び出されたときにコンテンツを再生タイムシフト手法（ onTimeShiftResume()。コンテンツがすでにクラウドに保存され、アプリで管理できる場合タイムシフト録画の場合は、代わりに Cloud Storage をできます

保護されたコンテンツを使用している場合、テレビ入力サービスが録画コンテンツを適切に暗号化し、コンテンツを復号化して、おすすめします。

録画した動画コンテンツには大量のストレージが必要になることがあるため、録画したコンテンツを慎重に管理する必要があります。再生中にセッション時間が、記録および保存できる時間をタイムシフトの録画を調整すると、ただし、確実に現在の時刻がキャプチャされるようにします。たとえば、ユーザーがの再生時間が 31 分で、タイムシフト録画が最長です。 30 分です。録画と開始時間を調整して、表示されます。

テレビ入力サービスがタイムシフトに対応していない場合は、通知する必要があります。通知する方法について詳しくは、タイムシフトのサポート制限について詳しくは、タイムシフトのステータスをシステムに通知する。

ユーザーが別のチャンネルに切り替えたときや、再生を終了したとき録画したタイムシフトデータを削除する。

タイムシフトのステータスをシステムに通知する

テレビ入力サービスがタイムシフトをサポートしている場合は、 notifyTimeShiftStatusChanged(TvInputManager.TIME_SHIFT_STATUS_AVAILABLE): 実装ユーザーがチューニングすると onTune() 追加できます

入力サービスのタイムシフト機能がある場合にシステムに通知する変更, 使用 notifyTimeShiftStatusChanged(int)。たとえば、テレビ入力サービスがタイムシフトをサポートしていない場合なんらかの理由で、Google Meet のビデオ会議が notifyTimeShiftStatusChanged(TvInputManager.TIME_SHIFT_STATUS_UNAVAILABLE)。

テレビ入力サービスがタイムシフトにまったく対応できない場合は、 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()。システムはこれらの呼び出しを使用して再生コントロール UI でタイムシフト時間を更新する。

再生パラメータをサポートする

タイムシフト中に再生速度を変更する際には再生パラメータが使用されます。対象たとえば、ユーザーが現在の再生を巻き戻すことにした場合、パラメータが負の再生速度でアプリに渡されている。タイムシフトは、2 倍または 3 倍の再生速度にも対応しています。早送りするだけです

システムは onTimeShiftSetPlaybackParams(PlaybackParams) メソッドを PlaybackParams オブジェクトで使用して、パラメータを指定します。この情報を使用してメディア再生エンジンを適切に設定する必要があります。

再生エンジンがパラメータをサポートしていない場合は想定される動作を可能な限りエミュレートします。たとえば再生がエンジンが 2 倍速に対応していない場合は、再生でシーク操作を繰り返す必要があります。約 2 倍の再生速度を実現しています

パラメータを設定した後は、ユーザーが次のいずれかの設定を行う場合を除き、設定を変更しないでください。別のパラメータまたはスイッチを必要とする再生コマンドを発行する選択しました

TV のユーザー操作を管理する

コンテンツの録画をサポートする