哔哩哔哩游戏SDK集成指南

哔哩哔哩游戏SDK开发包（简称：SDK）主要用来向第三方应用程序提供便捷、安全以及可靠的登录、支付等服务。本文主要描述SDK用户登录、支付等接口的使用方法，供合作伙伴的开发者接入使用。

接入前期准备工作包括商户签约和密钥配置，已完成商户可略过。 需要获取的参数包括：

重要提示：研发接入需根据不同app_id分配单独的服务器部署，基于平台游戏app_id+用户uid 对应游戏内用户唯一ID，以便区分用户。

本教程适用于AndroidStudio开发工具，如果您没有以上开发工具，可以到官网下载。

（1）工程根目录下新建libs文件夹,将aar文件放置到libs文件夹下

（3）根据游戏使用的架构库,选择SDK架构库,在gradle配置文件中添加如下代码:

游戏付费下载指的是用户需要先购买才能下载游戏，与用户可以免费下载但是游戏内有内购是不同的

获取BSGameSdk对象后，可以调用其中接口。每个接口方法的参数中都包含CallbackListener类型的，用户需实现其中的3个方法：onSuccess、onFailed和onError。当调用执行完毕返回结果时，会根据返回状态的不同执行其中相应的方法。

接入前，强烈建议运行Demo apk，从而全面了解我方SDK。接入的具体详情可以参考Demo Project

调用该方法，会打开哔哩哔哩游戏用户登录界面，引导用户输入用户名、密码来完成登录过程。

注意：停服相关公告请放在登录之前，停服维护期间不要调用SDK登录接口（若游戏有多个区服，停服维护的区服不可调用SDK接口，其他正常区服可调用）

(1)成功时执行onSuccess()方法，返回Bundle类型变量，其中包含键和值为：

1、请在用户登录并选择角色以及服务器后调用，否则无法通过审核； 2、notifyZone一次登录只能调用一次，不能多次调用。

支付之前请确认调用过notifyZone接口来设置当前区服信息,无需每次支付前都调用。PS：该支付结果仅作为参考，真实结果请以服务器结果为准

本次交易金额，单位：分（注意，total_fee的值必须为整数，并且在1~500000之间)

商品名称，如：金币。（由于支付宝不支持特殊字符 % &，所以参数中不能包含 % &）

支付接口的额外参数（请不要传入emoji等特殊字符），会在服务器异步回调中原样传回，长度不超过255

异步通知地址，为空时，使用正式支付回调地址进行支付回调，否则使用该地址进行支付回调，本字段用于游戏线下测试时支付异步通知地址，游戏包上线前请将此字段设置为空（）

1、为了保护游戏充值的安全性，此部分的签名操作一定要放在游戏服务端完成，否则暴露出游戏服务端secertkey会有很大风险。

2、uid 由 int类型变为 long类型，请检查所有涉及到uid参数的类型

错误码：7005。返回此异常的场景为，当CP进行支付时传入的uid与SDK本地存储的uid不同时SDK会返回7005的error code。

错误码：7004。返回此异常的场景为，新版微信支付过程中SDK通知发货失败，此时会返回7004的error bilibili sever查单接口，也可以等待bilibili server异步通知。

此接口会在用户登录失效时调用，请在收到监听时进行相关登出操作，回到游戏登录界面

(1)成功时执行onSuccess()方法，返回Bundle类型变量，其中包含键和值为：

(1)成功时执行onSuccess()方法，返回Bundle类型变量，其中包含键和值为：

(1)成功时执行onSuccess()方法，返回Bundle类型变量，其中包含键和值为：

(1)成功时执行onSuccess()方法，返回Bundle类型变量，其中包含键和值为：

订单参数签名错误，即order_sign参数值错误，请参考《哔哩哔哩游戏服务端接口文档》的2.2.3的订单参数加签规则

抵制不良游戏 拒绝盗版游戏 注意自我保护 谨防上当受骗 适度游戏益脑 沉迷游戏伤身 合理安排时间 享受健康生活

哔哩哔哩大会员2.68元/月，6.88元/3个月，请点本站上边链接购买

2020年12月21日 01:40:47

随机账号机器密码：
05GV3 TX12ep257
97DP827gxF90 ZL15aa943Zafu3
74VU308ymZ7 AB30zb591Q
60YP1 RH56ws
81AJ7 YP65wg076Pmsm
22SF240 HR34qx039Swqi
86KK760lwA43 FK55fi413Ylj
04FH60 TI81cx851Z
89F UU43mw072Mge
11SR94 AE06xa3