Skip to content
项目
群组
代码片段
帮助
当前项目
正在载入...
登录 / 注册
切换导航面板
Z
zw_game_sdk
概览
概览
详情
活动
周期分析
版本库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
统计图
问题
0
议题
0
列表
看板
标记
里程碑
CI / CD
CI / CD
流水线
日程表
维基
Wiki
代码片段
代码片段
成员
成员
折叠边栏
关闭边栏
活动
图像
聊天
创建新问题
提交
问题看板
Open sidebar
zwwl
zw_game_sdk
Commits
bb318ce1
提交
bb318ce1
authored
11月 29, 2023
作者:
刘添
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
更新 AndroidSDK对接文档.md
上级
ae0bed34
显示空白字符变更
内嵌
并排
正在显示
1 个修改的文件
包含
94 行增加
和
34 行删除
+94
-34
AndroidSDK对接文档.md
overseas/AndroidSDK对接文档.md
+94
-34
没有找到文件。
overseas/AndroidSDK对接文档.md
浏览文件 @
bb318ce1
# And
roid SDK 对接文档-v1.0
# And
roid SDK 对接文档-v1.0
...
@@ -8,9 +8,9 @@
...
@@ -8,9 +8,9 @@
1.2
[
数据字典
](
#sec1.2
)
1.2
[
数据字典
](
#sec1.2
)
1.
4
[
主动登录
](
#sec1.4
)
1.
3
[
SDK登录
](
#sec1.3
)
1.
5
[
下单逻辑
](
#sec1.5
)
1.
4
[
下单逻辑
](
#sec1.4
)
2.[
Android SDK 接入
](
#sec2
)
2.[
Android SDK 接入
](
#sec2
)
...
@@ -27,17 +27,16 @@
...
@@ -27,17 +27,16 @@
2.2
[
Android SDK 初始化
](
#sec2.2
)
2.2
[
Android SDK 初始化
](
#sec2.2
)
说明
配置游戏game_id
调用方式
示例
2.3
[
登录
](
#sec2.3
)
2.3
[
登录
](
#sec2.3
)
说明
说明
链接参数
登录
退出登录
示例
示例
...
@@ -81,8 +80,6 @@
...
@@ -81,8 +80,6 @@
> | 游戏服务 | 游戏研发商开发，为游戏提供服务。 |
> | 游戏服务 | 游戏研发商开发，为游戏提供服务。 |
> | 游戏客户端 | 游戏研发方商开发的网页版游戏。 |
> | 游戏客户端 | 游戏研发方商开发的网页版游戏。 |
> | 支付服务 | 由平台方调用支付服务，Google等 |
> | 支付服务 | 由平台方调用支付服务，Google等 |
> | 游戏盒子 | 由平台方开发的游戏总入口，可以实现游戏登陆，支付，切换等；Android 游戏以 iframe 的形式在游戏盒子中运行。 |
> | Android 游戏入口 | 由 CP 方提供，进入 Android 游戏的入口链接。 |
### 1.2 数据字典<a name="sec1.2"></a>
### 1.2 数据字典<a name="sec1.2"></a>
...
@@ -92,6 +89,7 @@
...
@@ -92,6 +89,7 @@
> | user_token | 用户在平台登录的会话标识。 |
> | user_token | 用户在平台登录的会话标识。 |
> | game_id | 主游戏下的平台的唯一标识。 |
> | game_id | 主游戏下的平台的唯一标识。 |
> | main_game_id | 主游戏在平台的唯一标识。 |
> | main_game_id | 主游戏在平台的唯一标识。 |
> | fm_app_key | 广告APPKEY(平台在出对接参数时提供) |
> | game_secret | 平台方提供，游戏签名秘钥。 |
> | game_secret | 平台方提供，游戏签名秘钥。 |
> | cp_order_id | 游戏研发商订单唯一标识 |
> | cp_order_id | 游戏研发商订单唯一标识 |
> | order_id | 平台方订单唯一标识，与 cp_order_id 一一对应 |
> | order_id | 平台方订单唯一标识，与 cp_order_id 一一对应 |
...
@@ -145,6 +143,7 @@ sequenceDiagram
...
@@ -145,6 +143,7 @@ sequenceDiagram
> | ----------- | ---------------------------------- |
> | ----------- | ---------------------------------- |
> | game_id | 游戏唯一标识，由平台方提供 |
> | game_id | 游戏唯一标识，由平台方提供 |
> | main_game_id | 主游戏唯一标识，由平台方提供 |
> | main_game_id | 主游戏唯一标识，由平台方提供 |
> | fm_app_key | 广告参数(平台提供) |
##### 导入示例
##### 导入示例
...
@@ -187,16 +186,21 @@ implementation 'com.zwwl.legend.sdk:legend:1.0.0'
...
@@ -187,16 +186,21 @@ implementation 'com.zwwl.legend.sdk:legend:1.0.0'
<meta-data
<meta-data
android:name="game_id"
android:name="game_id"
android:value="
1
"/>
android:value="
必须
"/>
//主游戏ID
<meta-data
<meta-data
android:name="main_game_id"
android:name="main_game_id"
android:value="1"/>
android:value="必须"/>
<meta-data
android:name="fm_app_key"
android:value="必填"/>
```
```
### 2.3
调用登录方法
<a name="sec2.3"></a>
### 2.3
登录
<a name="sec2.3"></a>
```
```
GameService.getInstance().showLogin(object : OnLoginListener<Any?> {
GameService.getInstance().showLogin(object : OnLoginListener<Any?> {
...
@@ -207,7 +211,7 @@ implementation 'com.zwwl.legend.sdk:legend:1.0.0'
...
@@ -207,7 +211,7 @@ implementation 'com.zwwl.legend.sdk:legend:1.0.0'
})
})
```
```
### 退出
登录方法
### 退出
```
```
GameService.getInstance().loginOut(object:InitZyCallback{
GameService.getInstance().loginOut(object:InitZyCallback{
...
@@ -268,6 +272,42 @@ private fun googlePlay(){
...
@@ -268,6 +272,42 @@ private fun googlePlay(){
}
}
```
```
##### 请求参数
> | 参数 | 必选 | 类型 | 默认值 | 说明 |
> | :------------------------------------------------------------ | :---- | :----- | :------- | :--------------------------------------------------------------------------------------------------- |
> | order | true | Object | - | 订单相关 |
> | cp_order_id | true | String | - | 游戏传入的外部订单号，服务器会根据这个订单号生成对应的平台订单号，请保证每笔订单传入的订单号的唯一性 |
> | product_price | true | String | - | 商品价格（单价，单位：分） |
> | product_id | true | String | - | 商品 ID |
> | amount | true | String | - | 商品总价（单位：分） |
> | product_cnt | true | String | - | 商品数量 |
> | product_name | true | String | - | 商品名称 |
> | product_desc | true | String | - | 商品描述 |
> | ext | false | String | "" | CP 自定义扩展字段，透传信息 |
> | role | true | Object | - | 角色相关 |
> | event | true | String | recharge | 充值上传的角色信息 |
> | server_id | true | String | "" | 游戏服务器 ID |
> | server_name | true | String | "" | 游戏服务器名称 |
> | cp_role_id | true | String | "" | 玩家角色 ID |
> | role_name | true | String | "" | 玩家角色名称 |
> | role_level | true | String | "0" | 玩家角色等级 |
> | role_vip | true | String | "0" | 玩家 VIP 等级 |
> | combat_num | false | Int | 0 | 角色战力 |
> | online_time | false | Int | 0 | 本次在线时长 |
##### 返回参数
> | 参数 | 类型 | 说明 |
> | :------------------------------------------------------------------------------------------------------- | :----- | :------------------------- |
> | status_code | String | 返回状态 |
> | msg | String | 返回信息 |
> | data | Object | 用户数据 |
> | data | Object | 用户数据 |
> | order_id | String | 订单 ID,可用于订单状态查询 |
### 2.5角色上报(角色上报参数字段请参考文档字段说明)<a name="sec2.5"></a>
### 2.5角色上报(角色上报参数字段请参考文档字段说明)<a name="sec2.5"></a>
```
```
...
@@ -309,25 +349,45 @@ private fun googlePlay(){
...
@@ -309,25 +349,45 @@ private fun googlePlay(){
```
```
##### 请求参数
| 名称 | 类型 | 是否必须 | 默认值|说明 |
|:--------------|-------:|-----:|-----:|-----------------:|
> | 参数 | 必选 | 类型 | 默认值 | 说明 |
| cp_order_id | string | 必须 || CP订单ID |
> | :---------------------------------------------------------- | :---- | :----- | :----- | :---------------------- |
| amount | number | 必须 | |商品总价（单位：分 |
> | role | true | Object | - | 角色信息 |
| product_price | number | 必须 | |商品价格(整数，后台自动换算分) |
> | event | true | String | other | 事件类型 |
| product_id | String | 非必须 |0| 商品ID |
> | server_id | true | String | - | 区服 ID |
| product_cnt | number | 必须 | |商品数量 |
> | server_name | true | String | - | 区服名称 |
| product_name | string | 必须 |""| 商品名称 |
> | cp_role_id | true | String | - | 游戏方角色 ID |
| product_desc | string | 非必须 |""| 商品描述 |
> | role_name | true | String | - | 游戏角色名称 |
| ext | string | 必须 |""| 订 调用方定义 单额外信息用（json）|
> | role_level | true | Int | - | 角色等级 |
| event | string | 必须 |""| 事件|
> | cp_account | false | String | - | cp 账号 |
| server_id | string | 必须 |0| 区服id |
> | role_vip | false | Int | 0 | 角色 VIP 等级(赞助等级) |
| server_name | string | 必须 |""| 区服名称|
> | combat_num | false | Int | 0 | 角色战力 |
| cp_role_id | string | 必须 | cp角色id |
> | reiki_num | false | Int | 0 | 角色灵符值 |
| role_name | string | 必须 | ""|角色名称 |
> | online_time | false | Int | 0 | 本次在线时长 |
| role_level | string | 必须 |0| 角色等级 |
> | attack | false | Int | 0 | 攻击力 |
| role_vip | string | 必须 | 0|角色vip等级 |
> | profession | false | String | - | 职业 |
| role_id | string | 必须 |0| 角色ID |
> | gang_name | false | String | - | 帮会(行会)名称 |
> | trans_level | false | Int | 0 | 转生等级 |
##### 返回参数
> | 参数 | 必选 | 类型 | 默认值 | 说明 |
> | ----------- | ---- | ------ | ------ | -------- |
> | status_code | true | Int | - | 状态码 |
> | msg | true | STRING | - | 返回信息 |
##### EVENT 枚举
> | EVENT | 说明 |
> | -------- | -------- |
> | create | 创建角色 |
> | online | 角色上线 |
> | offline | 角色下线 |
> | level_up | 角色升级 |
> | delete | 删除角色 |
> | recharge | 角色充值 |
> | other | 其他 |
编写
预览
Markdown
格式
0%
重试
或
添加新文件
添加附件
取消
您添加了
0
人
到此讨论。请谨慎行事。
请先完成此评论的编辑！
取消
请
注册
或者
登录
后发表评论
