@amazon-devices/kepler-content-personalization

オープンベータ版ドキュメント：本テクニカルドキュメントは、リリース前のオープンベータ版の一部としてAmazonから提供されるものです。ここで説明されている機能は、Amazonがフィードバックを受け取り、機能の開発を繰り返す過程で変更される可能性があります。最新の機能の情報については、リリースノートを参照してください。

KeplerコンテンツパーソナライゼーションAPIは、アプリ開発者がユーザーにパーソナライズされたエクスペリエンスを提供したり、関連性の高いコンテンツを表示したりすることができるようにする機能を提供します。

開始の手順

セットアップ

package.jsonファイルのdependenciesセクションに、以下のライブラリ依存関係を追加します。
クリップボードにコピーしました。
```
 "@amazon-devices/react-native-kepler": "~2.0.0",
 "react": "18.2.0",
 "react-native": "0.72.0",
 "@amazon-devices/kepler-content-personalization": "~1.2.0",
 "@amazon-devices/kepler-epg-provider": "~1.0.0",
 "@amazon-devices/head
```
- kepler-content-personalizationパッケージは、コンテンツパーソナライゼーションデータをシステムに送信する機能を提供します。
- amzn/kepler-epg-providerパッケージは、PlaybackEventデータモデルのchannelDescriptorに使用される依存関係を提供します。
- headless-task-managerパッケージは、データプルバックグラウンドサービスをシステムに登録する機能を提供します。

manifest.tomlに、以下の権限を追加します。

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

 schema-version = 1

 ## パッケージを定義します
 [package]
 title = "Kepler Videoアプリ"
 version = "2.17.0"
 id = "com.amazondeveloper.keplervideoapp"

 [components]
 ## アプリの対話型コンポーネントを定義します（まだ存在しない場合）
 [[components.interactive]]
 id = "com.amazondeveloper.keplervideoapp.main"
 library-name = "com.amazondeveloper.keplervideoapp"
 runtime-module = "/com.amazon.kepler.keplerscript.runtime.loader_2@IKeplerScript_2_0"
 categories = ["com.amazon.category.kva"]
 launch-type = "singleton"

 ## データリクエストを処理できるアプリのサービスコンポーネントを定義します。
 [[components.service]]
 id = "com.amazondeveloper.keplervideoapp.content.dataRefresh.provider"
 runtime-module = "/com.amazon.kepler.headless.runtime.loader_2@IKeplerScript_2_0"
 launch-type = "singleton"
 categories = ["com.amazon.category.kepler.media"]

 ## 各コンポーネントのプロセスグループを定義します
 [processes]
 [[processes.group]]
 component-ids = ["com.amazondeveloper.keplervideoapp.main"]

 [[processes.group]]
 component-ids = ["com.amazondeveloper.keplervideoapp.content.dataRefresh.provider"]

 [wants]
 ## アプリがコンテンツパーソナライゼーションデータサービスに依存していることを定義します
 [[wants.service]]
 id = "com.amazon.tv.developer.dataservice"

 [needs]
 ## コンテンツパーソナライゼーションインターフェイスを使用してデータを提供するためにアプリが必要とする権限を定義します
 [[needs.privilege]]
 id = "com.amazon.tv.content-personalization.privilege.provide-data"

 [offers]
 ## アプリのデータ更新サービスコンポーネントを定義します。
 [[offers.service]]
 id = "com.amazondeveloper.keplervideoapp.content.dataRefresh.provider"

 ## アプリの対話型コンポーネントを定義します
 [[offers.interaction]]
 id = "com.amazondeveloper.keplervideoapp.main"

 ## コンテンツパーソナライゼーションのサポートを宣言するためのエクストラを追加します
 [[extras]]
 key = "interface.provider"
 ## アカウントログインまたはコンテンツランチャーインターフェイスを利用している場合は、
 ## component-idを適切なサービスコンポーネントに置き換えます。アカウントログイン統合ガイドに従ってください。
 component-id = "com.amazondeveloper.keplervideoapp.content.dataRefresh.provider"

 ## コンテンツパーソナライゼーションのインターフェイスと属性のサポートを定義します
 [[extras.value.application.interface]]
 interface_name = "com.amazon.kepler.media.IContentPersonalizationServer"
 attribute_options = ["SupportedCustomerLists", "DataRefreshComponentId"]

 [extras.value.application.interface.static_values]
 SupportedCustomerLists = ["Watchlist"]
 DataRefreshComponentId = "com.amazondeveloper.keplervideoapp.content.dataRefresh.provider"

警告： 各インターフェイス構成は別個に指定する必要があります。マニフェストファイル内の異なるインターフェイス間で属性を結合したり混在させたりしないでください。

Keplerコンテンツパーソナライゼーションについて

モジュール

Last updated: 2025年10月2日

@amazon-devices/kepler-content-personalization

開始の手順

セットアップ

関連トピック

モジュール