SDK接入相关文件及参数介绍
在游戏接入小雪球发行SDK时，小雪球需要向开发商提供SDK涉及到的配置文件和参数，以便开发商接入后能正常的测试游戏登录、内购支付等功能。
1. 配置文件
| 文件名 | 适用端/渠道 | 说明 |
|---|---|---|
| google-services.json | Android (Google Play)Android (游戏官网) |
Google Firebase配置参数文件 |
| GoogleService-Info.plist | iOS (App Store) |
Google Firebase配置参数文件 |
2. 小雪球SDK配置信息
2.1 发行商提供的参数
请在小雪球给游戏提供的参数配置表文件中查看
| 参数名 | 所在文件名 | 适用端/渠道 | 说明 |
|---|---|---|---|
| Package Name | AndroidManifest.xml |
Android客户端 | android包的包名 |
| Bundle ID | Info.plist |
iOS客户端 | iOS包的包名 |
| SNB_INSTANCE_KEY | AndroidManifest.xmlInfo.plistsnb_confs.js |
客户端+服务端 | 小雪球SDK的游戏实例key |
| SNB_INSTANCE_SECRET | 游戏服务端自定义 | 服务端 | 小雪球SDK的游戏实例secret，数据签名生成和验签时使用 |
| SNB_API_PREFIX | AndroidManifest.xmlInfo.plistsnb_confs.js |
客户端 | 小雪球SDK服务端接口地址前缀 |
| GOOGLE_CLIENT_ID | AndroidManifest.xmlInfo.plistsnb_confs.js |
客户端 | Google登录使用的OAuth客户端id |
| GOOGLE_REVERSED_CLIENT_ID | Info.plist |
iOS客户端 | iOS端中Google授权登录后返回App的URL Scheme值 |
| GOOGLE_LICENSE_KEY | AndroidManifest.xml |
Android客户端 | Google Play渠道用来避免应用被未授权分发，测试iap使用 |
| FACEBOOK_APP_ID | AndroidManifest.xmlInfo.plistsnb_confs.js |
客户端 | Facebook登录使用的OAuth应用id |
| FACEBOOK_CLIENT_TOKEN | AndroidManifest.xmlInfo.plistsnb_confs.js |
客户端 | Facebook登录使用的OAuth客户token |
| FACEBOOK_DISPLAY_NAME | Info.plist |
iOS客户端 | Facebook登录OAuth授权界面中的App名称 |
| APPSFLYER_DEV_KEY | AndroidManifest.xmlInfo.plist |
客户端 | Appsflyer项目的key |
| APPLE_APP_ID | Info.plist |
iOS客户端 | iOS应用市场的应用id |
| SNB_PAGE_PRIVACY_URL | AndroidManifest.xmlInfo.plistsnb_confs.js |
客户端 | 小雪球SDK界面中的隐私政策地址 |
| SNB_PAGE_USERAGREEMENT_URL | AndroidManifest.xmlInfo.plistsnb_confs.js |
客户端 | 小雪球SDK界面中的用户协议地址 |
| SNB_PAGE_HELP_URL | AndroidManifest.xmlInfo.plistsnb_confs.js |
客户端 | 小雪球SDK界面中的帮助中心地址 |
| SNB_PAGE_FB_HOME_URL | AndroidManifest.xmlInfo.plistsnb_confs.js |
客户端 | 小雪球SDK界面中的Facebook社区主页地址 |
其他信息
此外，小雪球还会将SDK服务器的IP地址列表提供给开发商，在游戏开发接入SDK的服务端接口时，可针对这些IP进行白名单过滤。
2.2 开发商提供的地址
开发商需要根据SDK需求，提供以下几个http接口地址，方便SDK实现各种游戏充值相关的功能
| 地址名称 | 说明 |
|---|---|
GAME_IAP_NOTIFICATION_URL |
游戏内购物品发送的通知地址 |
GAME_OAP_NOTIFICATION_URL |
游戏外购虚拟货币发送的通知地址 |
GAME_REFUND_NOTIFICATION_URL |
游戏退款的通知地址 |
GAME_SERVERLIST_QUERY_URL |
游戏区服列表查询地址 |
GAME_ROLELIST_QUERY_URL |
游戏角色信息列表查询地址 |
2.3 开发商提供的游戏内购列表
开发商需要根据SDK需求，以Excel文件作为模板，提供以下游戏内购物品的列表给小雪球
| 商品id | 商品名称 | 货币类型 | 金额 | 商品描述 |
|---|---|---|---|---|
| iap001 | 钻石60 | USD | 0.99 | 购买60个钻石 |
| iap002 | 钻石300 | USD | 4.99 | 购买300个钻石 |
| ... | ... | ... | ... | ... |