接入前必读 | Funpepper

接入指南

接入环境说明

接入的环境分为测试环境和正式环境，一般在测试环境中接入成功验证没问题之后再发布到正式环境中。测试环境与正式环境对应的商户后台地址、接口地址、授权地址等是不同的。

成为开发者

获取游戏开发者的商户后台账号密码，可联系平台商务BD或运营。

商户后台创建、维护游戏信息

通过平台提供的账号、密码，登录商户后台，查看client_id和client_secret等必要信息

当前环境	商户后台地址(根据接入环境选择相应的地址)
测试环境	http://up-gameplatform.pengpengla.com
正式环境	http://gameplatform.upliveapp.com

一个开发者账号，可以创建多个不同的游戏
创建游戏时，需提供游戏名称、游戏链接、游戏ICON，除此以外还需声明游戏要发行的国家或地区（通过复选框勾选）

出于安全性考虑，务必保证游戏URL域名和开发者账号设置的游戏回调域名保持一致。

游戏服务端接入oauth/api

获取登录用户的基本资料、用户/U金币、加钻（金币）／扣钻（金币）来进行游戏，具体请参阅《授权登陆》和《接口列表》。
同样出于安全性考虑，开发者的client_secret以及获取用户的access_token不要暴露给客户端，建议在服务端做管理，否则会造成用户信息泄露。对于由此带来的平台损失，将有游戏开发者承担。

web端接入JSSDK

通过JSSDK，实现登录跳转、充值等交互，具体请参阅《前端JSSDK文档》

关于平台品牌包的说明

在客户端内部进入游戏的时，授权成功后平台会将feature拼接到游戏的回调地址上。如果有该参数，游戏方需要保证该参数在后续跳转的过程中不会丢失。

目前品牌包如下，三方需要根据不同的品牌包展示不同的ui（主要为钻石的替换）
其中Uplive为默认项，如果没有feature或者匹配不到对应的feature则使用Uplive的ui展示。

品牌包	feature	u钻素材链接
Uplive	无	Uplive U钻下载地址
Bubbly	777	Bubbly U钻下载地址
Haya	6666	Haya U钻下载地址

特别说明

sdk中的所有方法都依赖与init方法，因此在使用sdk之前要先调用openSdk.init方法。详情请查看JSSDK
为了提升速度，请开启gzip压缩以及资源缓存
sdk中的ping方法用于统计游戏PV、UV，请在游戏登录成功进入游戏之后务必调用openSdk.ping。如果在ping方法之后又页面跳转的操作，请在ping的success回调中执行，等待ping调用成功之后再进行页面跳转

FAQ

在接入过程中可能会遇到如下问题。浏览这些常见问题以查找对常见问题的解答。

1. 授权登录

Q：为什么授权的时候没有让我选择登录方式
A：如果是第一次使用funpepper授权，会使用游客进行登录，登录成功后进入游戏大厅退出登录，使用第三方登录，便可关闭游客登录的功能。在清除浏览器缓存之后会重新使用游客进行登录

Q：授权过程中提示系统异常
A：此类问题通常是由于调用openSdk.oauth时传递的redirect_url与管理后台中填写的域名不统一导致的

Q：使用code获取access_token是返回错误码000007
A：出现该错误码的原因通常为code验证没通过或者传递的redirect_uri与openSdk.oauth中传递的redirect_url不一样导致的。
新获取的code在使用一次之后就会立马失效，如果一直未使用，15分钟后将自动过期。请确保code是有效的。

Q：access_token的有效期是多久
A：access_token有效期较短,为12个小时，当access_token超时后，可以使用refresh_token进行刷新。refresh_token拥有较长的有效期为90天，当refresh_token也失效，需要用户重新授权。

2. 其它

Q：如何实现多语言
A：目前一个游戏链接只支持修改url上的_lang参数来实现多语言切换。不能使用不同的url来实现多语言。附常用多语言一览表

语言	语言码
简体中文	zh-CN
繁体中文	zh-TW
英语	en-US
日语	ja-JP
印尼语	id-ID
越南语	vi-VN
阿拉伯语	ar-EG

Q：可以设置几个回调域名
A：目前一个开发者只能设置一个回调域名。

Q：如何修改回调地址
A：如果回调地址的域名需要改动，需要联系平台商务BD或运营在平台后台进行修改，再由开发者去自己的商户后台进行修改。