米洛SDK产品概述

问题原因：

1. Application未正确继承WSdkApplication
2. AndroidManifest.xml中缺少meta-data配置
3. 未在Activity的onCreate中调用初始化方法
4. 未设置初始化回调监听器

解决方案：

• 确保游戏Application继承WSdkApplication
• 检查是否添加了mlsdk_gameId、mlsdk_ChannelName等参数
• 在Activity的onCreate中调用WsdkManger.getInstance(this).init(this)
• 在初始化前必须调用setInitLinstener设置回调

问题原因：Android 9.0默认禁止明文HTTP请求，targetVersion为28时会出现此问题

解决方案：

在AndroidManifest.xml的application节点下添加：

<application android:usesCleartextTraffic="true">

问题原因：未配置屏幕适配参数，导致部分分辨率设备显示异常

解决方案：

在AndroidManifest.xml的<manifest>内添加：

<supports-screens
    android:anyDensity="true"
    android:largeScreens="true"
    android:normalScreens="true"
    android:resizeable="true"
    android:smallScreens="true" />

接入要求：

1. 必须在登录界面获取到setLoginLinstener成功回调后，才能进入游戏界面
2. 从UserInfo中获取username、token、logintime
3. username是SDK返回的唯一ID，用于服务器验证用户
4. 调用登录接口前必须保证SDK已初始化成功

建议：在游戏登录界面调用SDK登录，成功后再跳转到游戏主界面

处理流程：

1. 收到setSwitchUserLinstener回调
2. 清除当前游戏角色信息
3. 使用新的UserInfo回到游戏界面
4. 重新选择区服角色进入游戏

注意：此回调内不需要再次调用登录接口

处理流程：

1. 获取到setLoginOutLinstener退出成功回调
2. 游戏回到登录界面
3. 重新调用登录方法
4. 清除当前游戏角色数据

上报时机：

• 创建角色后立即上报
• 进入游戏后上报
• 角色升级时上报（升级过快可升10级上报一次）

必填字段：

• ServerId - 服务器ID
• ServerName - 服务器名称
• RoleName - 角色名
• RoleId - 角色ID
• RoleLevel - 角色等级
• sign - 加密字段（必传，建议在服务端生成）

sign加密规则：

sign = md5(username + "#" + roleId + "#" + serverId + "#" + roleLevel + "#" + gameRolePower + "#" + mlsdk_appKey)

建议：无对应字段传空字符串，不要传null

正确做法：

在Activity的onBackPressed方法中调用：

@Override
public void onBackPressed() {
    WsdkManger.getInstance(this).showExitDialod(this);
}

说明：

• 如果SDK没有弹框返回-1，游戏需调用自己的弹框
• 有弹框时调用ExitLinstener.onSuccess()执行游戏退出逻辑

原因：SDK需要在各个生命周期节点执行相应操作，如暂停统计、恢复统计等

必须实现的方法：

• onCreate、onStart、onRestart
• onPause、onResume、onStop、onDestroy
• onNewIntent、onActivityResult
• onConfigurationChanged
• onRequestPermissionsResult

建议：直接复制文档中的生命周期代码，不要遗漏任何方法

常见原因及解决方案：

1. 初始化时机错误 - 必须在应用加载完成回调中调用（建议在初始化系统window之后）
2. Framework配置错误 - 确保MYWanSdk.framework状态设置为Embed && Sign
3. 架构设置错误 - 在Build Settings中将Architectures设置为armv7+arm64
4. 未等待初始化完成 - 必须收到kMYWanSDKNotiInitDidFinished通知后才能调用登录

建议：严格按照文档中的6个配置步骤逐一检查

问题原因：同时勾选横竖屏会导致SDK界面显示异常

解决方案：

• Device Orientation中只选中游戏兼容的方向
• 不要同时勾选横竖屏
• 如果游戏需要横竖屏切换，使用代码动态控制

解决方案：

• 在info.plist中添加允许HTTP访问的配置
• 在info.plist中添加允许获取设备码权限

注意：iOS 9.0+默认禁止HTTP请求，必须配置ATS

获取方式：

1. 收到kMYWanSDKNotiLogin登录成功通知
2. 从通知的userInfo中取得username、token、logintime
3. 或调用接口获取：username、token、logintime

重要说明：

• username是SDK的用户唯一标识，服务端的username就是这个值
• 必须以收到登录通知为准

排查步骤：

1. 确认已收到初始化成功通知kMYWanSDKNotiInitDidFinished
2. 检查gameid是否正确配置
3. 确认Framework已正确添加到工程
4. 查看Xcode控制台是否有错误日志

关键：登录接口必须在初始化成功后调用，否则会失败

触发场景：

• 调用logout接口
• 用户从渠道SDK内的用户管理界面注销

处理流程：

1. 收到kMYWanSDKNotiLogout通知
2. 回到游戏登录界面
3. 重新调用登录接口
4. 清除当前游戏角色信息

建议：一般认为注销成功，不用考虑失败情况

上报时机：

• 每次登录进入游戏后先调用一次updateRoleInfoWith:isCreate:
• 角色信息发生变化时调用

必填字段：

• serverId - 服务器id
• serverName - 服务器名称
• gameRoleName - 角色名
• gameRoleID - 角色id
• gameUserLevel - 玩家等级（没有传0）
• fightPower - 玩家战力（没有传0）
• sign - 加密sign（必传）

sign加密规则：

sign = md5(username + "#" + roleId + "#" + serverId + "#" + roleLevel + "#" + fightPower + "#" + mlsdk_appKey)

参数说明：

• isCreate表示是否为刚刚创建的角色
• 如果游戏没有某些字段，传空字符串即可

建议：登录成功后立即上报一次角色信息

必须转发的事件：

• applicationWillResignActive
• applicationDidEnterBackground
• applicationWillEnterForeground
• applicationDidBecomeActive
• applicationWillTerminate
• didRegisterForRemoteNotificationsWithDeviceToken
• didFailToRegisterForRemoteNotificationsWithError
• supportedInterfaceOrientationsForWindow
• openURL相关方法（3个）
• continueUserActivity

建议：直接复制文档中的AppDelegate代码，确保所有方法都已转发

使用方法：

• 显示浮动条：登录成功后调用showToolBar:
• 隐藏浮动条：调用hideToolBar
• 进入用户中心：调用enterUserCenter

注意：若渠道无对应接口，调用无效，不会报错

建议：用户登录成功后显示浮动工具栏，便于用户访问SDK功能

必须提供的信息：

1. 商家名称
2. 游戏名称
3. 游戏登录地址
4. 充值回调地址

米洛SDK会提供：

• 密钥对：mlsdk_Gameid、mlsdk_payKey、mlsdk_appKey
• 游戏测试地址

注意：必须先在测试地址中进行对接，才能唤起支付

重要安全提示：

• 每款游戏对应一组密钥对
• mlsdk_payKey、mlsdk_appKey不可直接暴露在前端
• 请妥善保存密钥对
• 如发现泄露，请尽快联系米洛SDK进行更换

建议：密钥相关操作应在服务端完成，前端只传递必要参数

引入JS类库：

<script src="https://unify.wancms.com/static/channel/libWancmsnewSDK.js"></script>

初始化：

var mlsdkgameid = '1'; // 后台自动分配
mlSDK.init(mlsdkgameid, true, function(){
    console.log("init success");
})

注意：必须先初始化，再调用其他接口

排查步骤：

1. 确保SDK已正确初始化
2. 检查callbackData.status是否为true
3. 从callbackData.data中获取uid、username、token

重要说明：

• 同一个用户对同一款游戏，username是固定不变的
• 可以将username与游戏自身的用户系统绑定
• 研发调用登录接口时返回username(用户唯一识别ID)及token(用户登录口令可以用于二次校验使用))，uid等信息

常见问题及解决方案：

1. 未在测试环境 - 必须在米洛SDK提供的测试地址中进行才能唤起支付
2. 缺少必填参数 - 确保所有必填参数正确传入
3. 参数类型错误 - rolelevel需为int，amount需为整数或浮点数
4. 订单号重复 - cpOrderNo每次支付必须生成新的唯一订单号

必填参数：

mlsdkgameid、uid、username、roleid、rolename、serverid、servername、rolelevel、cpOrderNo、amount、goodsname

必填字段：

• isCreateRole - 创建角色时true，其他传false
• uid、username
• serverid、servername
• rolename、roleid
• rolelevel - 类型需为int
• rolebalance - 角色用户余额，类型需为int
• viplevel - 类型需为int
• partyname - 公会社团

建议：选填字段没有则填空字符串，不要传null

配置方式：

• 游戏方需提供充值异步通知地址
• 充值成功后由米洛SDK服务端请求至游戏方服务器
• 异步get/post请求
• 请求参数详见服务端对接文档

注意：必须在接入前提供充值回调地址，否则无法完成支付流程

主动注销：

mlSDK.logout(function(logoutObject){
    console.log('Game:成功退出游戏');
})

监听注销通知：

mlSDK.setLogoutNotification(function(logoutObject){
    console.log('Game:玩家点击注销帐号');
})

处理流程：收到注销通知后，游戏应回到登录界面并清除角色数据

原因说明：

• 部分渠道SDK客户端不会发送正确的支付结果通知
• 客户端的支付回调仅供参考，不可依赖
• 必须通过服务端异步回调确认支付结果

正确做法：

1. 游戏服务端提供充值回调地址
2. 米洛SDK支付成功后调用该地址
3. 游戏服务端验证签名后发放道具
4. 返回成功响应

建议：客户端只负责唤起支付，不要根据客户端回调发放道具

Android签名规则：

sign = md5(username+"#"+roleid+"#"+cporderid+"#"+amount+"#"+mlsdk_appKey)

iOS签名规则：

sign = md5(username+'#'+roleid+'#'+cporderid+'#'+amount+'#'+mlsdk_appKey)

强烈建议：签名加密必须在服务端完成，不要在前端生成

原因：

• 前端代码容易被反编译，密钥会泄露
• 服务端生成更安全
• 便于统一管理和更换密钥

问题原因：每次支付必须使用唯一的订单号

解决方案：

• Android：cpOrderID每次支付生成新的唯一订单号
• iOS：cpOrderID每次支付生成新的唯一订单号
• H5：cpOrderNo每次支付生成新的唯一订单号

建议：使用时间戳+随机数生成订单号，例如：

// Java示例
String cpOrderId = "CP" + System.currentTimeMillis() + new Random().nextInt(1000);

处理原则：如果游戏没有某些字段，传空字符串

Android必填字段：

• amount - 总金额（保留两位小数）
• ServerId、ServerName
• RoleId、RoleName
• goodsName - 产品名称
• cpOrderID - 游戏订单号
• count - 游戏币数量
• goodsdesc - 产品描述
• extrasParams - 透传参数
• sign - 加密信息

建议：不要传null，传空字符串""

Android/iOS：

• 使用运营提供的测试地址
• 使用测试账号进行测试
• 测试环境不会产生真实扣费
• 正式上线前务必切换到生产环境

H5：

• 必须在米洛SDK提供的测试地址中进行才能唤起支付
• 游戏开发对接需在测试环境中完成

注意：测试完成后，记得切换到正式环境

配置步骤：

1. 接入前向米洛SDK提供充值回调地址
2. 确保URL可公网访问
3. 建议使用HTTPS协议
4. 米洛SDK会在后台配置该回调地址

验证步骤：

1. 接收米洛SDK的回调请求
2. 验证签名（防止伪造回调）
3. 验证时间戳（防止重放攻击）
4. 处理业务逻辑（发放道具）
5. 返回成功响应

响应格式：返回success表示处理成功

常见原因：

1. 密钥配置错误 - 服务器端配置的密钥与后台不一致
2. 参数被篡改 - 回调参数不完整或被修改
3. 签名算法错误 - 未使用正确的签名算法（MD5）
4. 编码问题 - 参数未使用UTF-8编码
5. 参数排序错误 - 参数未按字母顺序排序
6. sign参数参与签名 - sign本身不应参与签名计算

排查步骤：

1. 检查密钥是否正确
2. 打印参与签名的原始字符串
3. 对比签名算法实现
4. 使用文档提供的示例代码

建议：使用SDK提供的验签工具，避免手动实现出错

答案：不包含

正确步骤：

1. 从请求参数中取出sign值
2. 移除参数中的sign字段
3. 对其余参数进行签名计算
4. 将计算结果与sign值对比

注意：sign参数本身不参与签名计算

应急处理：

1. 立即联系米洛SDK更换密钥
2. 检查是否有异常订单
3. 排查密钥泄露原因

预防措施：

• 不要在前端代码中使用密钥
• 签名操作在服务端完成
• 不要在代码仓库中提交密钥
• 使用环境变量或配置文件管理密钥

建议：定期更换密钥，提高安全性

防护方法：

1. 验证时间戳：检查请求时间，超过5分钟的请求视为无效
2. 验证签名：确保请求参数未被篡改
3. 订单幂等性：同一订单号只处理一次

代码示例：

// 验证时间戳
long timestamp = Long.parseLong(params.get("timestamp"));
long currentTime = System.currentTimeMillis() / 1000;
if (Math.abs(currentTime - timestamp) > 300) {
    return "fail: timestamp expired";
}

建议：同时实现以上三种防护措施

问题背景：由于网络重试机制，同一订单可能收到多次回调

解决方案：

1. 数据库唯一约束 - 订单号设置唯一索引
2. 状态检查 - 处理前检查订单当前状态
3. 分布式锁 - 高并发场景使用Redis锁

代码示例：

// 检查订单状态
if ("PAID".equals(order.getStatus())) {
    return "success"; // 已处理，直接返回成功
}

建议：至少实现状态检查，高并发场景加分布式锁

问题说明：米洛SDK服务器等待回调响应的时间有限，超时会自动重试

正确做法：

// 推荐做法：先返回成功，再异步处理
app.post('/callback', (req, res) => {
    // 1. 快速验证签名
    if (!verifySign(req)) {
        return res.send('fail');
    }
    
    // 2. 异步处理业务逻辑
    async(() => {
        processOrder(req);
    });
    
    // 3. 立即返回成功
    res.send('success');
});

建议：耗时操作（如发送通知）异步处理，快速返回响应