实现直播场景扫码切换账号能力接入指南
收藏能力介绍
对开发者提供直播场景下观众扫码、主播切换账号的能力，以实现<看号、调号、起号、合宠、抽卡>等内容互动模式，提升用户体验与留存、助力主播内容经营
本文档是让开发者自主实现该能力的方案参考，具体应用需结合游戏本身
- •主粉互动乐趣多｜主播可在使用自身抖音账号直播的情况下，登录粉丝的小游戏账号，实现看号调号。
- •玩家游戏体验好｜粉丝可在确保抖音账号安全的情况下授权单个抖音小游戏、单次的登录让主播看号调号，提升账号价值 or 优化玩游戏的成本等。
功能核心逻辑
小游戏内可在1个抖音账号生成二维码后，结合平台提供的扫码api能力，支持用户扫码授权登录，实现多个小游戏账号的切换。
《指尖幻影》参考流程概述： | |||||
首页--扫码换号 | 主播点击扫码换号--生成二维码 | 用户截图保存点击游戏内扫一扫上传截图 | 主播显示扫码切换账号成功，点确定后进入游戏 | 用户显示扫码成功并退出游戏 | 号主登录时会自动“顶号” |
用户&主播侧体验流程示意
能力接入说明
1.小游戏内自行完成账号生成二维码能力
在游戏登录页面，当用户点击 “扫码登录” 按钮时，服务器需随机生成一个唯一标识符，如 UUID，将其作为键值存入数据库或缓存中，并设置过期时间。然后将此标识符与游戏相关的验证信息组合，通过二维码生成接口生成二维码，将二维码图片返回给前端展示给用户。
2.小游戏结合平台扫码能力实现扫一扫
3.小游戏内自行完成扫码信息解析
获取到服务器生成的唯一标识符等内容。手机端应用根据扫码结果，向服务器发送验证登录请求，请求中携带从二维码解析出的标识符以及用户在手机端的登录凭证。
4.小游戏内自行完成游戏登录账号的验证与授权
服务器收到手机端的请求后，根据标识符从数据库或缓存中获取相关信息，并验证用户的登录凭证。若验证通过，服务器生成一个游戏内的登录令牌或会话标识，将其与用户账号相关联，并记录登录状态。同时，可向手机端返回确认信息，提示用户是否确认登录，用户确认后，服务器完成授权过程。
注意⚠️：
1.切号进行充值会导致“不到账”（重要）：由于“玩家B的设备，登录上玩家A的账号，给玩家A的账号充钱”这种情况，创建的订单依然是机主玩家B的openid，实际登录的是玩家A的号，支付会导致不到账。最终这笔钱会消失，两边都没法到账，建议厂商自己对于“异号下单场景”进行判断和拦截，以免用户发生充值不到账的情况。
特殊风控
1.单次授权：扫码后仅当次有效，杀掉小游戏进程后重新进入恢复到抖音默认账号。
2. 用户顶号：用户侧如果在主播挂号期间进入游戏，主播侧强制弹窗“登录凭证已过期”并强行退出。
更多游戏案例参考
《指尖幻影》 | 开箱子玩法《大话仙境》 | 卡牌《口袋斗罗大陆》 | 《拳皇98终极之战》 |
