Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases
開発
設計と開発
公開
リファレンス
サポート
メインコンテンツへスキップ
VegaメディアアカウントログインAPIは、アプリの認証ステータスをシステムに報告する方法を提供します。

注釈

アプリでは、起動するたびにユーザーのログインステータスを更新する必要があります。これはアカウントログインAPIを通じて行われます。アカウントのログインステータスには、サインイン済みとサインアウトの2つがあります。アプリは、ログインステータスを最新の状態に保つことによって、ユーザーが適切なコンテンツや機能にアクセスできるようにします。このインターフェイスを使用すると、アプリの起動時とログイン状態の変更時に、ユーザーがログインしているかどうかを示すブール値をアプリから伝達できます。システムが必要に応じてこのステータスを照会することもできるため、パーソナライズされたユーザーエクスペリエンスが可能になります。 製品では、この情報を活用し、ユーザーが既に認証されているサービスのコンテンツを取り上げたりフィルタリングしたりして、コンテンツへのすばやいアクセスを実現できます。 アカウントログイン機能には、認証ステータスを管理するための主要な2つのコンポーネントとして、updateStatusメソッドとhandleReadStatusコールバック関数が含まれています。updateStatusメソッドは、認証状態が変更されたときに、アプリの現在のログインステータスを報告してリアルタイムで更新します。handleReadStatusコールバック関数は、アプリの現在のログインステータスに関するシステムからの照会に応答します。どちらのメソッドでも、アカウントステータスを表すにはStatusTypeが使用されます。これは、SIGNED_INとSIGNED_OUTの2つの値になる可能性があります。

開始する

セットアップ

  1. package.jsonファイルのdependenciesセクションに、以下のライブラリ依存関係を追加します。
  1. manifest.tomlに、アクセスするために必要な以下の権限を追加します。 注:マニフェストエントリを変更するときは、以下の例に示すように、 com.amazondeveloper.media.sampleを、アプリの実際のパッケージIDに置き換えてください。
メディアアプリは、多くの場合、次の3つの主要なAPIと統合する必要があります。
  • コンテンツランチャークラスターAPI。コンテンツを検索して起動するために使用します。
  • VegaメディアコントロールAPI。起動したメディアを制御するために使用します。
  • アカウントログインAPI。アカウントログインステータスをシステムに伝達するために使用します。
コンテンツランチャーAPIとVegaメディアコントロールAPIは、ほとんどの場合、Vegaメディアクエリを処理する対話型コンポーネントとして実装されます。このコンポーネントは、以下のTOMLスニペットや前の例に示されているように、アプリマニフェストのextrasセクションでinterface.providerキーを使用して指定します。
アカウントログインAPIはサービスアプリとして実装され、アプリ全体が起動していなくても、システムからのアカウントログインステータスの照会に応答できます。アカウントログインAPIは、サービスコンポーネントによって処理される1つのStatus属性を使用します。ログインステータス属性の操作が適切にルーティングされるようにするには、以下のTOMLの例や前の例に示されているように、アプリマニフェストでoverride_attribute_component設定を使用してサービスコンポーネントを指定する必要があります。
このアプローチを使用すると、システムパフォーマンスが最適化され、メディアコントロールとアカウント管理の機能を明確に切り分けることができます。

関連トピック

アカウントログイン統合ガイド

APIリファレンス

クラス

  • AccountLoginServerComponent - IAccountLoginServerAsyncインスタンスを作成するためのファクトリメソッドを提供します。
  • InternalError - セットアップエラーなどの内部エラー用のエラークラス。
  • InvalidArgumentError - 無効な引数例外のエラークラス。

インターフェイス

  • IAccountLoginHandlerAsync - AccountLoginコールバックを非同期的に処理するためのインターフェイス。
  • IAccountLoginServerAsync - 非同期AccountLoginServerのインターフェイス。
  • IStatus - ログインステータスを表すインターフェイス。
  • IStatusBuilder - Statusオブジェクトを構築するためのインターフェイス。
  • KeplerScriptAccountLogin - アプリのログインステータスを簡単に更新できます。

列挙型

  • StatusType - 有効なログインステータスタイプを表す列挙型。

最終更新日 2026年10月26日