手順3：最初のチャンネルを挿入する

リニアTVの統合

手順1：
TIF Companion Libraryをインポートする

→

手順2：
TvInputServiceをセットアップする

→

手順3：
最初のチャンネルを挿入する

→

手順4：
Fire TVのUIで再生する

次は最初のチャンネルを挿入します。この図に加えて、「Android開発の基本」のTIFアーキテクチャの図も参照してください。

マニフェストへのパーミッションの追加
AndroidのTVデータベースへのチャンネルメタデータの挿入
- 1つ目の方法： SetupActivityクラス
- 2つ目の方法： AndroidXライブラリで提供されるChannelオブジェクト
Gracenote IDの挿入
ディープリンクの挿入
チェックポイント - Fire TVのUIでのチャンネルの単独表示
トラブルシューティング
次のステップ

チャンネルと番組のメタデータは、TV入力によってTV入力フレームワーク（TIF）データベースに挿入されます。このデータは、Fire TVの [ライブ] セクションでサービスのライブコンテンツを表示するために使用されます。TV入力のチャンネルと番組のメタデータは、常に最新の状態で、アプリ内のデータと一致している必要があります。手順3および手順4では、このデータを挿入して最新の状態に保つ方法について説明します。

マニフェストへのパーミッションの追加

<uses-permission android:name="com.android.providers.tv.permission.WRITE_EPG_DATA" />
<uses-permission android:name="com.android.providers.tv.permission.READ_EPG_DATA" />

アプリがTIFデータベースとやり取りできるようにするには、これらのパーミッションをAndroidManifest.xmlに追加する必要があります。

注： EPGは、電子番組表の略です。

AndroidのTVデータベースへのチャンネルメタデータの挿入

AndroidのTVデータベースに最小限の構成のチャンネルを挿入する方法は2つあります。次のクラスまたはオブジェクトのいずれかにチャンネルを挿入できます。

import android.content.ContentValues;
import android.media.tv.TvContract;
import android.util.Log;
import android.net.Uri;

private long insertChannel() {
    ContentValues values = new contentValues();
    values.put(TvContract.Channels.COLUMN_INPUT_ID, "com.example.android.sampletvinput/.RichTvInputService");
    values.put(TvContract.Channels.COLUMN_DISPLAY_NAME, "My Test Channel");
    values.put(TvContract.Channels.COLUMN_DISPLAY_NUMBER, "3");

    Uri uri = getApplicationContext().getContentResolver().insert(TvContract.Channels.CONTENT_URI, values);
    Log.i("SetupActivity", "チャンネルを挿入しました。 URI：" + uri);
    long channelId = Long.parseLong(uri.getLastPathSegment());

    return channelId;
}

import android.app.Activity
import android.content.ContentValues
import android.media.tv.TvContract
import android.net.Uri
import android.util.Log

private fun insertChannel(): Long? {
    val values = ContentValues().apply {
        put(TvContract.Channels.COLUMN_INPUT_ID, "com.example.android.sampletvinput/.RichTvInputService")
        put(TvContract.Channels.COLUMN_DISPLAY_NAME, "My Test Channel")
        put(TvContract.Channels.COLUMN_DISPLAY_NUMBER, "3")
    }
    val uri: Uri? = applicationContext.contentResolver.insert(TvContract.Channels.CONTENT_URI, values)
    Log.i("SetupActivity", "チャンネルを挿入しました。 URI：$uri")
    return uri?.lastPathSegment?.toLongOrNull()
}

2つ目の方法： AndroidXライブラリで提供されるChannelオブジェクト

Java
Kotlin

import androidx.tvprovider.media.tv.Channel;
import android.media.tv.TvContract;
import android.util.Log;
import android.net.Uri;

private long insertChannel() {
    Channel testChannel = new Channel.Builder()
        .setDisplayName("My Test Channel")
        .setDisplayNumber("3")
        .setInputId("com.example.android.sampletvinput/.RichTvInputService")
        .build();

    Uri uri = getApplicationContext().getContentResolver().insert(TvContract.Channels.CONTENT_URI, testChannel.toContentValues());
    Log.i("SetupActivity", "チャンネルを挿入しました。 URI：" + uri);
    long channelId = Long.parseLong(uri.getLastPathSegment());

    return channelId;
}

import android.app.Activity
import android.content.Context
import android.media.tv.TvContract
import android.util.Log
import androidx.tvprovider.media.tv.Channel


private fun insertChannel(): Long? {
    val testChannel = Channel.Builder()
        .setDisplayName("My Test Channel")
        .setDisplayNumber("3")
        .setInputId("com.example.android.sampletvinput/.RichTvInputService")
        .build()
    val uri: Uri? =
        contentResolver.insert(
            TvContract.Channels.CONTENT_URI,
            testChannel.toContentValues()
        )
    Log.i("SetupActivity", "チャンネルを挿入しました。 URI：$uri")
    return uri?.lastPathSegment?.toLongOrNull()
}

次に、このメソッドをSetupActivity内のonCreate()メソッドで呼び出します（既存のコードを置き換えます）。

Java
Kotlin

public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.rich_setup);

    insertChannel();
}

public override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.rich_setup)
    
    insertChannel()
}

アクティビティ	必須・任意	入力	備考
`COLUMN_INPUT_ID`	必須	TvInputServiceへの完全なクラスパス	例： TvInputServiceがメインアプリパッケージにある場合、完全なクラスパスは、`<アプリパッケージ>/<TvInputServiceへの相対パス>`になります。 TvInputServiceが別のパッケージにある場合、inputIdは、`<アプリパッケージ>/<別のパッケージのフルパス + TvInputServiceへのパス>`になります。
`TvContract.Channels.CONTENT_URI`	必須		AndroidのTVデータベース内のチャンネルテーブルを指すURIです。
`ContentResolver.bulkInsert()`または`ContentResolver.applyBatch()`	必須（本番用コードの場合）		いずれかを使用すると、1回のデータベース操作ですべてのチャンネルの挿入が行われます。

注：チャンネルごとに、Androidのチャンネル列を使用して、利用可能なすべてのメタデータを1つのContentValuesインスタンスに格納する必要があります。チャンネルの使用可能な全メタデータ列のリファレンスを参照してください。

Gracenote IDの挿入

Gracenoteを使用していない場合は、このセクションをスキップしてください。

重要： GracenoteアカウントはあるもののGracenote IDが不明な場合は、この手順を進める前に、Gracenoteの担当者にお問い合わせください。

GracenoteはTVカタログのプロバイダーで、Fire TVと統合してクラウドからチャンネルや番組のメタデータを提供します。コンテンツがGracenoteと統合されている場合は、一意のIDを指定し、Fire TVがそのIDを使用してこのメタデータを収集できるようにすることができます。Gracenoteとの統合に関心がある場合は、Amazonの担当者にお問い合わせください。

以下は、AmazonのコントラクトキーでタイプとIDを指定して、チャンネルの一意のGracenote IDをJSONオブジェクトに挿入する例を示しています。これは、SetupActivityのチャンネル挿入関数内に配置します。

Java
Kotlin

/**
 * 外部IDのタイプを格納する変数。サービスメタデータのマッチングに使用されます。有効なタイプは
 * 「EXTERNAL_ID_TYPE_」で始まる名前の定数として以下で定義されます。
 * Nullまたは無効なデータを使用すると、サービスメタデータの
 * マッチングに失敗します
 */
private final static String EXTERNAL_ID_TYPE = "externalIdType";

/**
 * 外部IDの値を格納する変数。サービスメタデータのマッチングに使用されます。
 * Nullまたは無効なデータを使用すると、サービスメタデータのマッチングに失敗します
 */
private final static String EXTERNAL_ID_VALUE = "externalIdValue";

/**
 * 外部プレーヤーへの再生のディープリンクURI。
 */
private final static String PLAYBACK_DEEP_LINK_URI = "playbackDeepLinkUri";

// Gracenote入力タイプのID
private final static String GRACENOTE_ID = "gracenote_ontv"; // onTV用Gracenote ID
private final static String GRACENOTE_GVD = "gracenote_gvd"; // GVD用Gracenote ID

// 再生ディープリンクURIのコントラクト​
// Intent.URI_INTENT_SCHEMEを使用して、インテントからURIを作成したり、URIを元のインテントに戻したりします
Intent playbackDeepLinkIntent = new Intent(); // アプリで作成されます
String playbackDeepLinkUri = playbackDeepLinkIntent.toUri(Intent.URI_INTENT_SCHEME);

// BLOBを作成します
ContentValues values = new ContentValues();  // すべてのチャンネルデータを格納します
ContentResolver resolver = context.getContentResolver();
values.put(TvContract.Channels.COLUMN_DISPLAY_NAME, "＜実際の表示名＞");
values.put(TvContract.Channels.COLUMN_INPUT_ID, "＜実際の入力ID＞");
try {
    String jsonString = new JSONObject()
                  .put(EXTERNAL_ID_TYPE, "＜実際のIDタイプ＞") // GRACENOTE_XXXに置き換えます
                  .put(EXTERNAL_ID_VALUE, "＜実際のID値＞") // チャンネルに関連付けられたGracenote ID値に置き換えます
                  .put(PLAYBACK_DEEP_LINK_URI, playbackDeepLinkUri).toString();

    values.put(TvContract.Channels.COLUMN_INTERNAL_PROVIDER_DATA, jsonString.getBytes());
} catch (JSONException e) {
    Log.e(TAG, "BLOBにデータを追加するときにエラーが発生しました " + e);
}

Uri uri = resolver.insert(TvContract.Channels.CONTENT_URI, values);

import android.app.Activity
import android.content.ContentValues
import android.content.Intent
import android.media.tv.TvContract
import android.util.Log
import org.json.JSONException
import org.json.JSONObject

/**
 * 外部IDのタイプを格納する変数。サービスメタデータのマッチングに使用されます。有効な
 * タイプは「EXTERNAL_ID_TYPE_」で始まる名前の定数として以下で定義されます。Nullまたは無効なデータを使用すると、
 * サービスメタデータのマッチングに失敗します
 */
private const val EXTERNAL_ID_TYPE = "externalIdType"
/**
 * 外部IDの値を格納する変数。サービスメタデータのマッチングに使用されます。Null
 * または無効なデータを使用すると、サービスメタデータのマッチングに失敗します
 */
private const val EXTERNAL_ID_VALUE = "externalIdValue"
/**
 * 外部プレーヤーへの再生のディープリンクURI。
 */
private const val PLAYBACK_DEEP_LINK_URI = "playbackDeepLinkUri"
// Gracenote入力タイプのID
private const val GRACENOTE_ID = "gracenote_ontv" // onTV用Gracenote ID
private const val GRACENOTE_GVD = "gracenote_gvd" // GVD用Gracenote ID



class SetupActivity : Activity() {
    private fun insertChannel(): Long? {
        // 再生ディープリンクURIのコントラクト​
        // Intent.URI_INTENT_SCHEMEを使用して、インテントからURIを作成したり、URIを元のインテントに戻したりします
        val playbackDeepLinkIntent = Intent() // アプリで作成されます
        val playbackDeepLinkUri = playbackDeepLinkIntent.toUri(Intent.URI_INTENT_SCHEME)

        val jsonString: String? = try {
             JSONObject()
                .put(EXTERNAL_ID_TYPE, "＜実際のIDタイプ＞") // GRACENOTE_XXXに置き換えます
                .put(
                    EXTERNAL_ID_VALUE,
                    "＜実際のID値＞"
                ) // チャンネルに関連付けられたGracenote ID値に置き換えます
                .put(PLAYBACK_DEEP_LINK_URI, playbackDeepLinkUri)
                .toString()
        } catch (e: JSONException) {
            Log.e(TAG, "BLOBにデータを追加するときにエラーが発生しました", e)
            null
        }

        // BLOBを作成します
        val values = ContentValues().apply { // すべてのチャンネルデータを格納します
            put(TvContract.Channels.COLUMN_DISPLAY_NAME, "＜実際の表示名＞")
            put(TvContract.Channels.COLUMN_INPUT_ID, "＜実際の入力ID＞")
            if (jsonString != null) {
                put(TvContract.Channels.COLUMN_INTERNAL_PROVIDER_DATA, jsonString.toByteArray())
            }
        }

        val uri = contentResolver.insert(TvContract.Channels.CONTENT_URI, values)

        Log.i("SetupActivity", "チャンネルを挿入しました。 URI：$uri")
        return uri?.lastPathSegment?.toLongOrNull()
    }
}

private val TAG = "MyTAG"

アクティビティ	必須・任意	備考
`externalIdType`と`externalIdValue`	必須	これらのフィールド名は、Fire TVにGracenote情報を提供するための、開発者とAmazonとのコントラクトの一部です。これらの文字列は変更しないでください。
`TvContract.Channels.COLUMN_INTERNAL_PROVIDER_DATA`	必須	Fire TVにディープリンクとGracenote情報を提供するための、開発者とAmazonとのコントラクトの一部です。

注：現時点では、地域に応じて、GVD（グローバルビデオデータ）とonTVの2つのGracenoteタイプがサポートされています（米国、英国、ドイツではOnTV、その他の地域ではGVD）。

別のタイプのGracenote IDを保有している場合は、その種類を確認してください。これについてご不明な点がある場合は、Amazonの担当者にお問い合わせください。
Gracenoteを使用する予定はあるもののGracenote IDがまだない場合は、開発目的で次のIDを一時的に使用できます。米国、英国、ドイツでは、 10171（Disney Channel）、10240（HBO）、12131（Cartoon Network）のサンプルIDを、gracenote_ontvのexternalIdTypeで使用できます。それ以外のマーケットプレイスでは、 GN9BBXQSECYVNGW（HBO）のサンプルIDを、gracenote_gvdのexternalIdTypeで使用できます。

重要： チャンネルがディープリンクとGracenote IDをサポートしている場合は、上記のコントラクトを使用して、両方を同じJSONオブジェクトに挿入する必要があります。

ディープリンクの挿入

Amazonのコントラクトキー文字列playbackDeepLinkUriを使用して、ディープリンクをJSONオブジェクトに挿入します。

Java
Kotlin

/**
 * 外部プレーヤーへの再生のディープリンクURI。
 */
private final static String AMZ_KEY_PLAYBACK_DEEP_LINK_URI = "playbackDeepLinkUri";

...

Intent playbackDeepLinkIntent = new Intent();
...
// チャンネルのcontentValuesを作成します
ContentValues values = new contentValues();
values.put(Channels.COLUMN_INPUT_ID, inputId);
values.put(Channels.COLUMN_DISPLAY_NAME, channel.name);
...
// ディープリンクインテントを作成します
playbackDeepLinkIntent = // プロバイダーのチャンネルのディープリンクインテント
    ...
    try {
        String jsonString = new JSONObject()
            .put(AMZ_KEY_PLAYBACK_DEEP_LINK_URI, playbackDeepLinkIntent.toUri(Intent.URI_INTENT_SCHEME))
            .toString();

        // チャンネルのcontentValuesにjsonStringを追加します
        values.put(TvContract.Channels.COLUMN_INTERNAL_PROVIDER_DATA, jsonString.getBytes());
    } catch (JSONException e) {
        Log.i(TAG, "BLOBにデータを追加するときにエラーが発生しました " + e);
    }

Uri uri = context.getContentResolver().insert(TvContract.Channels.CONTENT_URI, values);

import android.app.Activity
import android.content.ContentValues
import android.content.Intent
import android.media.tv.TvContract
import android.util.Log
import org.json.JSONException
import org.json.JSONObject

/**
 * 外部プレーヤーへの再生のディープリンクURI。
 */
private const val AMZ_KEY_PLAYBACK_DEEP_LINK_URI = "playbackDeepLinkUri"

class SetupActivity : Activity() {
    private fun insertChannel(): Long? {
        val playbackDeepLinkIntent = createPlaybackDeepLinkIntent() // プロバイダーのチャンネルのディープリンクインテント

        // チャンネルのcontentValuesを作成します
        val values = ContentValues().apply {
            put(
                TvContract.Channels.COLUMN_INPUT_ID,
                "com.example.android.sampletvinput/.RichTvInputService"
            )
            put(TvContract.Channels.COLUMN_DISPLAY_NAME, "My Test Channel")
        }

        try {
            val jsonString = JSONObject()
                .put(
                    AMZ_KEY_PLAYBACK_DEEP_LINK_URI,
                    playbackDeepLinkIntent.toUri(Intent.URI_INTENT_SCHEME)
                )
                .toString()

            // チャンネルのcontentValuesにjsonStringを追加します
            values.put(
                TvContract.Channels.COLUMN_INTERNAL_PROVIDER_DATA,
                jsonString.toByteArray()
            )
        } catch (e: JSONException) {
            Log.i("SetupActivity", "BLOBにデータを追加するときにエラーが発生しました $e")
        }

        val uri = contentResolver.insert(TvContract.Channels.CONTENT_URI, values)

        Log.i("SetupActivity", "チャンネルを挿入しました。 URI：$uri")
        return uri?.lastPathSegment?.toLongOrNull()
    }

    private fun createPlaybackDeepLinkIntent(): Intent = TODO()
}

アクティビティ	必須・任意	備考
`playbackDeepLinkUri`	必須	Fire TVにチャンネルのディープリンクを提供するための、開発者とAmazonとのコントラクトの一部です。この文字列は変更しないでください。
`TvContract.Channels.COLUMN_INTERNAL_PROVIDER_DATA`	必須	Fire TVにディープリンクとGracenote情報を提供するための、開発者とAmazonとのコントラクトの一部です。

チェックポイント - Fire TVのUIでのチャンネルの単独表示

APKをビルドしてFire TVにインストールします。
[設定] > [ライブTV] > [チャンネル提供元を同期] の順に選択し、提供元を選択します。
[ホーム] > [放映中のチャンネル] 行に移動します。挿入したチャンネルが、カード（コンテンツを含むボックスで、タイルとも呼ばれます）の1つとして表示されます。Gracenote以外の場合は、チャンネル名の付いた灰色のタイルが表示されます。デバイスでほかの提供元のチャンネルが多数存在する場合は、挿入したチャンネルが表示されないこともあります（上限があります）。
[ライブTV] > [番組表] に移動してオプションメニュー（3本線）を開き、[チャンネルを絞り込み] を選択して、入力名を選択します。挿入したチャンネルが画面に1行で表示されます。
[設定] > [ライブTV] > [チャンネルを管理] の順に選択します。（ジョブサービスのXMLファイルにある）入力名がリストに表示されます。ここに、挿入したチャンネルが割り当てられています。
（ディープリンクを使用している場合）[放映中のチャンネル] 行のチャンネルカードをクリックします。アプリが起動し、想定されるチャンネルが表示されます。
（Gracenoteが統合されている場合）[放映中のチャンネル] 行と番組表に、チャンネルの完全な番組メタデータが表示されます。

トラブルシューティング

[放映中のチャンネル] 行または番組表にチャンネルが表示されない

チェックポイントを参照して、チャンネルが許可リストに追加されていることを確認します。
チャンネルのinputIdが、TvInputServiceへの完全なクラスパスと同じであることを確認します。
デバッグ用APKと本番用APKのパッケージ名が同じであることを確認します。
チャンネルがTIFに正しく挿入されていることを確認します。
- 挿入後すぐにチャンネル情報のハードコードクエリを作成し、チャンネルがデータベース内に存在することを確認します。
Amazonでチャンネルが正しく取得されていることを確認します。
- チャンネルを挿入する前に、adbログを確認します。
  
  Mac/Linux：adb logcat | grep StationSync
  
  Windows：adb logcat | findstr StationSync
- チャンネルを挿入すると、以下のようなログが表示されます。「added」は、AmazonがAndroidのTVデータベース内の新しいチャンネルを認識していることを意味します。

08-07 15:24:57.101 11882 11941 I StationSync: Started full channel sync
08-07 15:24:57.188 11882 11941 I StationSync: Finished full channel sync, found: 15, added: 1, removed: 0, updated: 0

[放映中のチャンネル] でチャンネルが空のタイルとして表示され、画像が表示されない（チャンネル名のみが表示される）

これは、チャンネルがGracenoteに統合されていない場合に想定される動作です。Gracenoteが統合されている場合は、以下を参照してください。

Gracenote IDが割り当てられているチャンネルのメタデータが [放映中のチャンネル] または番組表に表示されない

フィードがonTVとGVDのどちらに対応しているかを確認し、TvContractUtilsで正しく定義してください。特定のマーケットプレイスのAmazonカタログでは、onTVがサポートされています。保有しているGracenote IDのタイプがAmazonでサポートされるタイプと一致しない場合は、Amazonの担当者にお問い合わせください。Gracenoteと連携して問題を修正するか、TIFに切り替えることになります。
Gracenote ID値を再度確認してください。onTVでは数値のみ、GVDでは英数字が使用されています。

注：既存のチャンネルや番組をAndroidのTVデータベースに照会するためのリソースを参照してください。

次のステップ

次の手順の手順4： Fire TVのUIで再生するに進みます。

Last updated: 2024年7月16日

手順3： 最初のチャンネルを挿入する