as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持
跳转到主要内容
简单登录服务API提供的功能允许第三方应用开发者将其用户账户的应用账户与客户注册设备时使用的亚马逊账户关联起来。然后,开发者可以针对后续登录尝试,使用链接无缝地让用户登录。 该API支持以下功能:
  • 将第三方应用用户的账户与亚马逊账户关联。
  • 为第三方应用的用户获取现有链接。
  • 对第三方应用用户显示带有选项的选择界面以进行登录。
  • 记录业务指标。

开始使用

设置

  1. 将以下库依赖项添加到package.json文件的dependencies部分。
  1. 在您的manifest.toml中,添加以下权限。
    这些权限提供对以下事项的访问权限:
    • 简单登录系统服务的访问权限。
    • 允许显示征求用户同意的屏幕。
    • 允许向用户显示登录选项的屏幕。

用法

以下部分介绍如何使用简单登录执行账户关联以及让用户登录。 以下示例发起请求,要求在您的应用所在的设备上,为当前活跃的亚马逊用户提取与简单登录相关的数据。

LinkUserAccount

以下示例中,为用户的应用账户启动了账户关联。该示例允许在亚马逊和应用账户之间进行N:N映射。可以有多个应用账户同时与一个亚马逊账户关联,一个应用账户可以关联多个亚马逊账户。

ShowLoginSelection

以下示例中,打开了一个对话框,向用户显示登录选项。在调用此方法之前,获得每个关联账户的易于用户识别的标识符,并将该标识符添加到请求中。要检索标识符,请调用getUserAndLinks() 方法。用户可识别的标识符包括登录名、电子邮件地址或个人资料名称。该代码在屏幕上显示这些标识符,以帮助客户轻松识别关联的应用账户。

RecordMetricEvent

以下示例触发一个为发布指标而记录的事件。可以在开发者控制台的报告选项卡中下载简单登录业务指标报表。利用这些指标,可以深入了解与简单登录集成的业务价值和影响。

实现登录流程

在实现登录流程之前,您需要身份提供者名称 (IDP_NAME),该名称是在应用的引入过程中在开发者控制台中提供的。这个唯一标识符将您的应用连接到简单登录服务。

开始使用登录

登录过程通常在以下情况下开始:
  • 应用启动时
  • 用户单击登录按钮
  • 会话需要身份验证
以下示例显示如何使用GetUserAndLinks() 方法实现基本登录流程。

账户关联流程

成功进行标准登录后,您应该关联用户的账户,以便为将来的会话启用无缝登录。此过程在用户的亚马逊账户和您的应用的账户之间建立安全连接。 以下示例使用应用的标准登录方法将用户账户关联到您的应用。 用户每次使用应用的标准登录流程登录时,都会调用LinkUserAccount() 方法。

故障排除

  1. 未显示同意屏幕或登录选择屏幕。\ 确保您的清单已更新。
  2. API调用在请求状态中返回FEATURE_TURNED_OFF。 用户已在账户级别、设备级别或针对您的应用禁用了简单登录功能。
  3. API调用在请求状态中返回NOT_AVAILABLE。 简单登录功能在设备运行时所在的区域不可用。

API参考

类

  • SimpleSignService—提供与亚马逊简单登录框架进行交互的主要API。

枚举

类型别名


最后修改于 2026年10月26日