幸运魔方（随机道具）接入指南
收藏能力介绍
开发者在直播玩法后台开启并接入「幸运魔方」功能，即可在小摇杆内展示出「幸运魔方」，激发直播间观众参与兴趣，让用户快速体验玩法爽感，实现用户付费破冰。
接入流程
2.1 能力配置
配置项 | 配置说明 | 示意图 |
直播间礼物互动能力配置 |
|
2.2 API接入
沿用获取礼物数据
幸运魔方加密对外的礼物ID：9tPFzcpEQFovisU3j3coz5tqj/qQ5LHJQJWob/X5bLbxm1s7kYLj0aGSb4k=
若开发者开启「幸运魔方」开关，且用户送出「幸运魔方」，则礼物数据推送中将增加sec_magic_gift_id字段，代表用户送出了幸运魔方礼物，sec_gift_id为幸运魔方随机到的礼物，请结合「sec_gift_id」和「gift_num」输出对应礼物效果
开发者请务必校验礼物数据中test字段，如果 test字段为 true ，代表推送的是测试数据，应在数据统计场景进行过滤（如榜单场景），否则存在数据统计异常的风险，需自行担责。
测试数据生产来源说明：1）开放平台控制台的自查工具模拟发送的测试数据；2）版本发布时，因平台审核玩法交互表现等，模拟发送的测试数据；
[ { msg_id: "123456782", // string类型id sec_openid: "xxxx", // 用户的加密openid，当前其实没有加密 sec_gift_id: "xxxx", // 加密的礼物id gift_num: 123, // 送出的礼物数量 gift_value: 10000, // 礼物总价值，单位分 avatar_url: "xxx", // 用户头像 nickname: "xxxx", // 用户昵称(不加密) timestamp: 1649068964, // 礼物毫秒级时间戳 test: true, // 如果是抖音平台的测试数据，则会下发该字段且值为 true。测试工具下发的送礼数据属于调试模式，不会有该字段 audience_sec_open_id:"xxx", // 被送礼的嘉宾openid，当前没有加密 sec_magic_gift_id: "xxx", // 加密的幸运魔方礼物id（有该字段，代表的是由幸运魔方抽取到的礼物。sec_gift_id是幸运魔方抽取到的礼物） }, ];
2.3 能力测试
测试项 | 配置说明 | 示意图 |
openAPI自测 |
| |
直播间测试 |
| / |
Q&A
- 1.为什么开启开关之后，在调试环境看不到幸运 魔方礼物？
当前未打开用户侧开关，用户侧暂时无法看到幸运魔方礼物，对前期进行接入的厂商，会将厂商侧已配置的调试成员加入可见名单，若仍出现看不见幸运魔方礼物的问题，可告知运营，提报抖音号名单。
- 2.礼物流水数据如何统计？
通过sec_magic_gift_id字段判断用户是否送出幸运魔方，若送出则流水记为1钻。
- 3.玩家每日可使用次数上限？
为保障对每个接入玩法的公平性，每个用户单日单玩法可付费1钻使用送出1次幸运魔方（随机道具）。目前试跑，玩家侧透传为“限时福利”。暂定暑期期间使用，后续使用方式另行通知。
- 4.厂商如何分成？
用户1钻付费，主播、厂商也将分成按照1钻进行结算。
- 5.随机概率规则及控制方式？
目前会按礼物单价金额映射对应玩法效果，分为“高价值组”、“中价值组”、“低价值组”3档，并分别按单礼物区间给予概率，概率根据效果价值增高而降低。每日单玩法内，平台会控制上“高价值组”效果可随机到总数量上限，以避免对厂商的玩法影响。
- 6.厂商画布内该如何展示效果？
平台玩家送礼气泡信息会显示为“送出幸运魔方X1”，主播感知收到1钻礼物。厂商可自行选择用默认随机到的效果展示，或自行优化补充展示信息（注意需符合提审要求）。
