游戏的需求洞察
许多互联网产品想要拓宽功能领域，纷纷选择进入小游戏赛道，试图从新颖有趣的方向深度触达用户，提高产品的活跃度和留存。群玩洞察了这一需求，还发现海外用户也对1v1互动游戏感兴趣，于是开始做这类游戏的研发和设计工作。对于有开发需求的企业来说，不需要额外再去自主开发，开发者将游戏直接应用接入到社交场景即可（如直播间、社交app、聊天party等），节省了企业二次开发的时间和精力，也能更专注于自身的业务。
1v1小游戏有哪些？
1v1双人互动小游戏，其中包括了比较经典的童年回忆小游戏：石头剪子布（猜拳）、五子棋等；
手游类：飞行棋（1v1）、登山赛、象棋、井字棋等；
知识竞猜类：猜歌、猜图片、猜谜语、成语接龙、趣味问答等。
群玩PAAS-互动功能低代码接入平台
对于长期使用社交app的用户来说，适当地游戏互动对于社交有一定的帮助，也许还能借着游戏打开话题，找到同频好友。那么作为开发者/运营者，就可以从用户思维出发，思考用户需要的是什么，然后将需求做出来以供用户使用。这样既能提高对产品的好感度和满足感，吸引用户留存，还能为产品带来新的变现机会，推动营收增长。
如何接入一款互动小游戏？
一般来说，企业想要新增一款游戏到应用有两个方法，一是自行开发，二是交给小游戏服务商进行开发。对于游戏类企业，其本身的专业性和资源足以支撑开发一款新的游戏。然而对于没有游戏开发经验的中小企业来说，游戏的开发是一项需要场地、设备、人力技术资源协同配置的工作，需要投入的成本也非常高，不利于长期的运营维护。
那么找到相关的服务商后，又该如何接入到需要的应用页面或是社交场景里呢？
以群玩互动游戏为例，搜索进入专属的网站，可以通过点击相应的按钮了解已开发好的游戏产品和服务。看中心仪的游戏就可以自行注册接入，也可以与技术沟通了解具体的操作。除了已开发好的游戏可以直接应用，也可以根据行业特色提出个性化需求，让开发者进行修改和新增，以获得更契合产品的方案。
SDK、API、游戏大厅等接入方式，适用于直播间、app、小橙序等多个社交场景，对于用户留存和促活有着不可言喻的作用。
接入概述
接入流程
直接嵌入互动内容、游戏等，服务已经将玩法开发完成，可以根据需求修改或默认玩法规则，无需再次开发。
- 创建应用
- 获取accountSecToken
- 依据接口文档实现业务逻辑
第一步：创建应用
登录开放平台官网后，在管理中心创建应用，在审核成功后，开通游戏服务。
第二步：获取accountSecToken
accountSecToken的使用及生成方式说明：
- accountSecToken是用户在客户端操作凭据，建议开发者在服务端获取accountSecToken。
接入流程图
请求方式
POST http://open.doyep.cn/api/account/login
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | string | 应用id |
| timeStamp | 是 | string | 时间戳(毫秒) |
| nonceStr | 是 | string | 随机字符串 |
| sign | 是 | string | MD5签名 |
| uid | 是 | string | 用户唯一标识 |
| uname | 否 | string | 用户昵称 |
| headImg | 否 | string | 用户头像URL |
返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| accountSecToken | string | 用户token |
| imUrl | string | im连接地址 |
返回示例
{
"code": "200",
"message": "操作成功",
"success": true,
"data": {
"accountSecToken": "e6aa932ca44e433aa9a9a32d00e54083",
"imUrl": "ws://192.168.101.128:8888"
}
}
签名生成规则
private static String genSign(String appSecurity, Map<String, String> params) {
//1. 参数名按照ASCII码表升序排序
String[] keys = params.keySet().toArray(new String[0]);
Arrays.sort(keys);
//2. 按照排序拼接参数名与参数值
StringBuilder sb = new StringBuilder();
for (String key : keys) {
sb.append(key).append(params.get(key));
}
//3. 将secretKey拼接到最后
sb.append(appSecurity);
//4. MD5是128位长度的摘要算法，转换为十六进制之后长度为32字符
try {
byte[] bytes = sb.toString().getBytes("UTF-8");
return DigestUtils.md5Hex(bytes);
} catch (UnsupportedEncodingException e) {
e.printStackTrace();
}
return null;
}
第三步：依据接口文档实现业务逻辑 立即接入
游戏大厅接入流程
注意事项
1、需应用申请通过后才能接入
获取accountSecToken 和imUrl 连接地址
请求方式
POST http://open.doyep.cn/api/account/login
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | string | 应用id |
| timeStamp | 是 | string | 时间戳(毫秒) |
| nonceStr | 是 | string | 随机字符串 |
| sign | 是 | string | MD5签名 |
| uid | 是 | string | 用户唯一标识 |
| uname | 否 | string | 用户昵称 |
| headImg | 否 | string | 用户头像URL，建议传入否则会导致头像无法显示 |
请求示例
{
"timeStamp":1663207750000,
"uid":"2334",
"uname":"何时",
"headImg":"https://www.doyep.cn/static/img/undercover.44746290.png",
"appId":"16341843345645",
"sign":"c8d68af6848f90a328bf42c403e12759",
"nonceStr":"fd5c15816d204518aee17625717a0db9"
}
返回示例
{
"code":"200",
"message":"操作成功",
"success":true,
"data":{
"accountSecToken":"e6aa932ca44e433aa9a9a32d00e54083",
"imUrl":"ws://192.168.101.128:8888"
}
}
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| accountSecToken | string | 用户token |
| imUrl | string | im连接地址 |
参数传入
https://hall.doyep.cn?accountSecToken=${accountSecToken}&imUrl=${imUrl}
