loginWithDoubaoWidget
在 Widget 中拉起平台登录和隐私协议授权交互。
使用限制
WARNING
Android、iOS:Android 仅区分 0(隐私流程)与非 0(登录流程),iOS 按当前隐私授权状态路由、仅记录 loginType 不据其分流,两次弹窗与合并弹窗语义均未生效;调用方无法通过 loginType 精确控制弹窗形态。
支持版本
前端库版本不低于 0.0.19。
支持平台
支持场景
接入准备
前置条件
- Android:当前豆包账号需已绑定手机号
- iOS:当前豆包账号需已绑定手机号
使用说明
此 API 只处理 loginType 对应的平台交互,不会返回 login() 的一次性 login_code,
也不会替业务方创建应用插件登录态或完成 MCP Token 交换。
当前豆包账号未绑定手机号时,调用会报错。业务方应捕获错误并降级到自定义登录流程。
业务方仍需按实际场景完成服务端账号登录;MCP 授权登录还需在业务服务端生成三方短期兑换 code,
并通过 postLoginResult 回传最终登录结果。
- 调用会主动拉起授权登录弹窗,请在用户明确触发登录的交互场景中调用;请勿在无用户操作的后台逻辑中调用。调用报错时,业务方应降级到自定义登录流程。
调用方式
异步 API
入参
调用示例
成功返回
返回示例
错误处理
错误对象和通用错误码见 通用错误处理。
失败示例
错误码
通用错误码
平台差异
- Android:状态查询成功但关键数据缺失返回 112;其他失败统一返回 102。
- iOS:失败统一返回 102。