注釈
アプリでは、起動するたびにユーザーのログインステータスを更新する必要があります。これはアカウントログインAPIを通じて行われます。アカウントのログインステータスには、サインイン済みとサインアウトの2つがあります。アプリは、ログインステータスを最新の状態に保つことによって、ユーザーが適切なコンテンツや機能にアクセスできるようにします。このインターフェイスを使用すると、アプリの起動時とログイン状態の変更時に、ユーザーがログインしているかどうかを示すブール値をアプリから伝達できます。システムが必要に応じてこのステータスを照会することもできるため、パーソナライズされたユーザーエクスペリエンスが可能になります。 製品では、この情報を活用し、ユーザーが既に認証されているサービスのコンテンツを取り上げたりフィルタリングしたりして、コンテンツへのすばやいアクセスを実現できます。 アカウントログイン機能には、認証ステータスを管理するための主要な2つのコンポーネントとして、updateStatusメソッドとhandleReadStatusコールバック関数が含まれています。updateStatusメソッドは、認証状態が変更されたときに、アプリの現在のログインステータスを報告してリアルタイムで更新します。handleReadStatusコールバック関数は、アプリの現在のログインステータスに関するシステムからの照会に応答します。どちらのメソッドでも、アカウントステータスを表すにはStatusTypeが使用されます。これは、SIGNED_INとSIGNED_OUTの2つの値になる可能性があります。
開始する
セットアップ
- package.jsonファイルの
dependenciesセクションに、以下のライブラリ依存関係を追加します。
-
manifest.tomlに、アクセスするために必要な以下の権限を追加します。
注:マニフェストエントリを変更するときは、以下の例に示すように、
com.amazondeveloper.media.sampleを、アプリの実際のパッケージIDに置き換えてください。
- コンテンツランチャークラスターAPI。コンテンツを検索して起動するために使用します。
- VegaメディアコントロールAPI。起動したメディアを制御するために使用します。
- アカウントログインAPI。アカウントログインステータスをシステムに伝達するために使用します。
override_attribute_component設定を使用してサービスコンポーネントを指定する必要があります。
関連トピック
アカウントログイン統合ガイドAPIリファレンス
クラス
- AccountLoginServerComponent -
IAccountLoginServerAsyncインスタンスを作成するためのファクトリメソッドを提供します。 - InternalError - セットアップエラーなどの内部エラー用のエラークラス。
- InvalidArgumentError - 無効な引数例外のエラークラス。
インターフェイス
- IAccountLoginHandlerAsync -
AccountLoginコールバックを非同期的に処理するためのインターフェイス。 - IAccountLoginServerAsync - 非同期AccountLoginServerのインターフェイス。
- IStatus - ログインステータスを表すインターフェイス。
- IStatusBuilder - Statusオブジェクトを構築するためのインターフェイス。
- KeplerScriptAccountLogin - アプリのログインステータスを簡単に更新できます。
列挙型
- StatusType - 有効なログインステータスタイプを表す列挙型。

