备注
应用需要在每次启动时刷新用户的登录状态,这通过账户登录API实现。有两种账户登录状态:登录和注销。通过保持最新的登录状态,应用可确保用户有权访问相应的内容和功能。借助此接口,无论是在应用启动时,还是在应用登录状态发生变化时,应用都可以传递表示用户是否已登录的布尔值。系统还可以根据需要查询此状态,从而实现个性化用户体验。 产品可以利用这些信息来展示或筛选已验证用户身份的服务中的内容,从而让用户即时访问内容。 账户登录功能提供两个用于管理身份验证状态的关键组件:updateStatus方法和handleReadStatus回调函数。updateStatus方法报告应用的当前登录状态,以便在身份验证状态发生变化时进行实时更新。handleReadStatus回调函数可以响应有关应用当前登录状态的系统查询。两种方法都使用StatusType来表示账户状态,可能有两个值:SIGNED_IN和SIGNED_OUT。
开始使用
设置
- 将以下库依赖项添加到package.json文件的
dependencies部分。
-
在您的manifest.toml中,添加访问所需的以下权限。
注意: 修改清单条目时,请将
com.amazondeveloper.media.sample替换为应用的程序包ID,如下例所示。
- 用于查找和启动内容的内容启动器集群API
- Vega媒体控制API,用于控制启动的媒体
- 账户登录API用于向系统传达账户登录状态
override_attribute_component设置指定服务组件,如本TOML示例以及之前的示例所示。
相关主题
账户登录集成指南API参考
类
- AccountLoginServerComponent—提供用于创建
IAccountLoginServerAsync实例的工厂方法。 - InternalError—内部错误(例如设置失败)的错误类。
- InvalidArgumentError—无效参数异常的错误类。
接口
- IAccountLoginHandlerAsync—用于异步处理
AccountLogin回调的接口。 - IAccountLoginServerAsync—异步AccountLoginServer的接口。
- IStatus—表示登录状态的接口。
- IStatusBuilder—用于构建Status对象的接口。
- KeplerScriptAccountLogin—便于更新应用的登录状态。
枚举
- StatusType—表示可能的登录状态类型的枚举。

