@amazon-devices/kepler-channel

@amazon-devices/kepler-channelパッケージは、Vega向けReact Nativeアプリがチャンネル変更操作を処理できるようにする機能を提供します。このパッケージは、Vegaを基盤として作成されたTVアプリのチャンネル変更とチャンネルスキップ機能をサポートします。

はじめに

セットアップ

1. package.jsonファイルのdependenciesセクションに、以下のライブラリ依存関係を追加します。

1. manifest.tomlに、Vegaチャンネル機能にアクセスするために必要な以下の権限を追加します。

   コードをコピー クリップボードにコピーしました。

    [components]
    ## アプリの対話型コンポーネントを定義します（まだ存在しない場合）
    [[components.interactive]]
    id = "<パッケージID>.main"
    runtime-module = "/com.amazon.kepler.keplerscript.runtime.loader_2@IKeplerScript_2_0"
    launch-type = "singleton"
    categories = ["com.amazon.category.main", "com.amazon.category.kepler.media"]
   
    [[extras]]
    ## interface.providerは、特定のインターフェイスの実装を提供する
    ## コンポーネントを指定します。
    key = "interface.provider"
    ## インターフェイスの実装を提供するコンポーネントを宣言します。
    ## このコンポーネントは[[components.interactive]]に定義されている必要があり、
    ## そのカテゴリーには"com.amazon.category.kepler.media"が含まれています。
    component-id="<パッケージID>.main"
   
    [extras.value.application]
    ## Vegaチャンネルのサポートを宣言します。
    [[extras.value.application.interface]]
    interface_name = "com.amazon.kepler.media.IChannelServer"
    features = ["ChannelList"]
   
    ## チャネルデータの提供にはVega EPGプロバイダーを使用するため、ChannelList属性を[]にハードコードします
    [extras.value.application.interface.static-values]
    ChannelList = []
   

   メインの対話型コンポーネントに追加されている2つのカテゴリーの詳細は以下のとおりです。

   • com.amazon.category.mainは、コンポーネントをアプリパッケージのデフォルトの対話型コンポーネントとして宣言します。
   • com.amazon.category.kepler.mediaは、コンポーネントをVegaのメディア操作のターゲットとして宣言します。

関連トピック

• Vegaチャンネルの統合

APIリファレンス

クラス

• ChangeChannelResponse
• InternalError - 操作を実行しようとした際に内部エラーが発生した場合にスローされるエラー。
• InvalidArgumentError - 無効な引数が渡されたときにスローされるエラー。
• OperationError - 「IChannelHandler」がチャンネルクラスターの処理に失敗した場合にスローされるエラー。

インターフェイス

• IChangeChannelResponse - チャンネル変更コマンドに使用されるIChangeChannelResponseのインターフェイス。
• IChangeChannelResponseBuilder - ビルドに使用されるChannelResponseBuilderのインターフェイス。
• IChannelHandler - チャンネルクラスタープロバイダーが提供するハンドラーのインターフェイス。このインターフェイスはチャンネルを処理する必要があります
• IChannelServer - チャンネルのハンドラーを設定する機能を持つChannelServerのインターフェイス。
• IChannelServer2 - 設定機能を提供するChannelServerのインターフェイスのリビジョン2。
• IChannelServerComponent - チャンネルクラスターサーバーインスタンスを提供するコンポーネント。
• IChannelServerComponent2 - 「ChannelServerComponent」インターフェイスのリビジョン2。

列挙型

• ChangeChannelStatus - チャンネル変更コマンドの応答のステータスを表す列挙型。

---

Last updated: 2026年7月22日