Console

Settings

Sign out

Notifications

Alexa

Amazonアプリストア

Ring

AWS

ドキュメント

Support

My Cases

Console

Fire OSドキュメント

ホーム

開発

テスト

公開

収益化

ユーザーエンゲージメント

デバイスの仕様

リソース

一般的なトラブルシューティング

このページでは、Fire TV統合SDKとの統合に関する一般的な問題について説明します。

重要： コンテンツIDやプロフィールIDなど、機密性の高いIDはログに出力されません。これは、機密データの漏洩を防ぐための想定された動作です。

デバイス上にSDKログが生成されない
アプリでFire TV統合SDKを呼び出してSDKログを生成していても、[続きを観る] 行にコンテンツが何も表示されない
Fire TVシステムでデータ統合サービスが呼び出されない
Fire TV統合SDKの機能チェックでtrueが返されても、デバイスで [続きを観る] 行が表示されない
[続きを観る] 行が想定どおりに動作しない
バックグラウンドプロセスが終了するシナリオの処理
- バックグラウンドに関する情報
  - Androidのプロセスフロー
  - 複数のインスタンスにわたる状態の保存
- 以前のインテントをディープリンクなどに使用しても機能しない
  - オプション1
  - オプション2

デバイス上にSDKログが生成されない

デバイスがサポートされていない: サポート対象のデバイスを使用していることを確認してください。現在サポートされているデバイスタイプのリストについては、Amazonの担当者に確認してください。
デバイスのソフトウェアが古い: サポート対象のデバイスを使用している場合は、最新のソフトウェアがインストールされていることを確認してください。[設定] > [My Fire TV] > [バージョン情報] の順にクリックし、[アップデートをチェック] をクリックします。
アーティファクトがアプリに正しく組み込まれていない: サポート対象のデバイスを使用していて、最新のソフトウェアがインストールされている場合は、アーティファクトがアプリに正しく組み込まれていることを再確認してください。詳細については、Fire TV統合SDKをアプリに組み込むを参照してください。

アプリでFire TV統合SDKを呼び出してSDKログを生成していても、[続きを観る] 行にコンテンツが何も表示されない

チェックポイント#1 - 機能が有効になっていることを確認する

使用中のCustomerIDでコンテンツパーソナライゼーション機能が有効になっていることを確認します。そのためには、[設定] > [環境設定] > [プライバシー] > [アプリによる共有を管理]の順にクリックします。[アプリによる共有を管理] オプションが表示されない場合は、Amazonの担当者に連絡し、CustomerIDとDSNをお知らせください。

**[設定] > [環境設定] > [プライバシー設定]** に想定されるメニュー項目

チェックポイント#2 - アプリが許可リストに登録されていることを確認する

[設定] > [環境設定] > [プライバシー設定] > [アプリによる共有を管理] > [Manage by App]の順にクリックして、アプリが許可リストに登録されていることを確認します。アプリが登録されていない場合は、次の手順を実行します。

アプリがデバイスにインストールされていることを確認します。このリストには、インストール済みのアプリのみが表示されます。
[Amazonコンテンツを同期] をクリックし、15分ほど待ってからもう一度リストを確認します。
それでもアプリがリストに表示されない場合は、Amazonの担当者に連絡し、開発に使用しているCustomerID、DSN、パッケージ名をお知らせください。

アプリは **[設定] > [環境設定] > [プライバシー設定] > [アプリによる共有を管理] > [Manage By App]**の下のリストに表示されます。

チェックポイント#3 - 機能がオンになっていることを確認する

アプリが許可リストに登録されていることを確認したら、機能が有効になっていることを確認します。そのためには、[設定] > [環境設定] > [プライバシー設定] > [アプリによる共有を管理] に移動し、[アプリの視聴状況とコンテンツ情報の共有] 機能を [オン] に設定します。

**[アプリの視聴状況とコンテンツ情報の共有]** を **[オン]** に設定する必要があります。

それでもアプリが見つからない

次の条件を満たしていることを確認してください。

サポート対象のデバイスを使用していて、最新のアップデートがインストールされている。
Fire TV統合SDKを始める - 手順4までが完了している。
チェックポイント#3で、機能の有効化とアプリの許可リストへの登録を確認した。
カタログファイルに指定されているAmazonコンテンツIDを使用していることを確認した。

それでも [続きを観る] 行にコンテンツが表示されない場合は、Amazonの担当者に問題を報告してください。

Fire TVシステムでデータ統合サービスが呼び出されない

この機能はまだ有効になっていませんが、統合の一部として実装する必要があります。実装はAmazonの内部で検証されます。

Fire TV統合SDKの機能チェックでtrueが返されても、デバイスで [続きを観る] 行が表示されない

デバイスによっては、SDKライブラリを読み込むことはできても、続きを観るエクスペリエンスがまだ完全にはサポートされていない場合があります。機能チェックはライブラリが利用可能かどうかを示すだけで、機能が利用できることを保証するものではありません。これらのデバイスは将来サポートされる可能性があるため、引き続きデバイスでFire TV統合SDKの呼び出しを行うことをお勧めします。現在続きを観る機能がサポートされているデバイスのリストは、Amazonの担当者から入手できます。

[続きを観る] 行が想定どおりに動作しない

トラブルシューティングを参照してください。

バックグラウンドプロセスが終了するシナリオの処理

フォアグラウンドプロセスにメモリが必要な場合、Android OSはほかのプロセスを停止してメモリを解放します。ただし、アクティビティの履歴はアクティビティスタックに残ります。アクティビティが再開されるときは、プロセスが停止する前の元の起動インテントを使用して起動されます。次に、2つ目の最新のインテントがonNewIntent()コールバックを使用して実行されます。

バックグラウンドに関する情報

Androidのプロセスフロー

プロセスフローを知っておくと、OSがプロセスとインテントをどのように使用するかを理解しやすくなります。

サードパーティアプリ（アクティビティA）がディープリンクインテント（インテントA）で起動されます。
ActivityA.onCreate()が呼び出され、getIntent()がインテントAを生成します。
アクティビティAがバックグラウンドに移行し、ユーザーがほかのアプリや機能を使用します。
Androidのローメモリキラーデーモン（lmkd）がアクティビティAを停止し、メモリを解放します。
ActivityA.onDestroy()が呼び出され、アクティビティAのプロセスが停止します。

重要： Android OSがアクティビティAのプロセスを停止した後も、アクティビティAはアクティビティスタックに残り、元の起動インテントを含むアクティビティの状態が記憶されます。
アクティビティAが、後で別のユースケースのために異なるインテント（インテントB）で起動されます。
ActivityA.onCreate()が呼び出されますが、getIntent()は引き続きインテントAを生成します。
1. singleTop、singleTask、singleInstanceなどの標準以外の起動モードを使用する場合、Android OSはタスクのアクティビティが既に存在するかどうかを確認し、onNewIntent()コールバックを使用してインテントのルーティングを試みます。
2. 標準の起動モードでは、ターゲットタスクの新しいインスタンスを作成し、その新しいインスタンスにインテントを配信する必要があります。
次にActivityA.onNewIntent()が呼び出され、インテントBがコールバックのインテントとして使用されます。

複数のインスタンスにわたる状態の保存

Android OSによってプロセスがバックグラウンドで終了されると、システムはまずonSaveInstanceState(Bundle)を呼び出して、アクティビティが状態情報をインスタンスの状態バンドルに保存できるようにします。アクティビティの次回起動時のonCreate()では、保存されたインスタンスバンドルを使用して、このプロセスがAndroid OSによる終了後に再起動されたものか、新しく起動されたアクティビティかを判別できます。

メモリを解放する場合、アクティビティは終了しませんが、アクティビティが実行しているプロセスは停止します。アクティビティを再作成すると、保存されたインスタンスをバンドルから復元できます。

詳細については、以下を参照してください。

以前のインテントをディープリンクなどに使用しても機能しない

ディープリンクが機能しない場合は、最新のインテントではなく以前のインテントが選択されていることが原因である可能性があります。この問題を解決するには2つの方法があります。

オプション1

最初の方法は、アプリから受け取った最新のインテントを使用することです。ディープリンクで正しい情報が表示されない場合、最新のインテントを使用していないことが原因である可能性があります。最新でないインテントはすべて、システムによって破棄または無視されます。

詳細については、onNewIntent()を参照してください。

オプション2

2つ目の方法では、専用のアクティビティを使用してディープリンクの受信と転送を行います。この方法の利点は、ディープリンクの処理後にアクティビティでfinish()を呼び出して、アクティビティの履歴から自身を削除できることです。次回起動時にonCreate()などのライフサイクルコールバックからgetIntent()を使用するときには、アクティビティに最新のインテントが含まれています。このため、システムはonNewIntent()コールバックを待つ必要がなくなります。

Last updated: 2026年5月27日