# 常规登陆账号体系
[客户端] --> username|password --> [服务器] <---> 数据查询存在并生成授权token

# 第三方发行账号体系
[客户端] --> username|password --> [CP服务器]
                                    |
                                    |--> [appid, username, password] + 发行申请的 secretKey 哈希出 token
                                                    |
                                                    |--> [第三方发行服务器]
                                                                |
                                                                | --> 数据查询存在并生成授权token
                                                                            |
                                                                            |
                                                              如果存在账号返回信息, 不存在就创建账号入库
                                                                            |
                                  [CP服务器] <------------------------------ |
                                    |
                                    |
                (可选步骤,有的CP方需要记录入库来保存, 也有的CP方不想维护独立服务器)  
                验证发行返回的账号是否在 CP 自己维护的数据库用户表存在, 不存在就创建
                                    |
                                    |
[客户端] <------------- 将发行的验证的授权凭证数据返回客户端

<?php

// 基础数据
$appid = 1001; // 应用ID
$appKey = "c53d93bafeb52c0be562613daef647de";// 参与哈希Key
$channel = 11; // 渠道标识
$time = 1747335102;// 秒级时间戳

// 渠道所需数据
$extension = json_encode([
	"username" => "meteorcat",
	"password" => "password"
]);
echo "extension: '{$extension}'".PHP_EOL;

// 合并成参数列表, appKey 不参与哈希
$params = [
	'appid' => $appid,
	'channel' => $channel,
	'time' => $time,
	'extension' => $extension
];


// 按照Key正序排序
ksort($params);
echo str_repeat("=",84).PHP_EOL;
var_dump($params);
echo str_repeat("=",84).PHP_EOL;


// 构建 Key1=Value1&Key2=Value2 形式
// 注意 http_build_query 会按照 url 方编码, 需要 urldecode 解码处理下
$encrypt = urldecode(http_build_query($params));
echo "encrypt: '{$encrypt}'".PHP_EOL;
echo str_repeat("=",84).PHP_EOL;

// 添加 appKey 
$encryptWithKey = "$encrypt$appKey";
echo "encryptWithKey: '{$encryptWithKey}'".PHP_EOL;
echo str_repeat("=",84).PHP_EOL;

// 最后处理成 sign
$sign = md5($encryptWithKey);
echo "sign: '{$sign}'".PHP_EOL;
echo str_repeat("=",84).PHP_EOL;

// 最后合并到提交 form 表单参数
$params['sign'] = $sign;
var_dump($params);
echo str_repeat("=",84).PHP_EOL;

# 最后展示打印内容数据如下
# extension: '{"username":"meteorcat","password":"password"}'
# ====================================================================================
# array(4) {
#   ["appid"]=>
#   int(1001)
#   ["channel"]=>
#   int(11)
#   ["extension"]=>
#   string(46) "{"username":"meteorcat","password":"password"}"
#   ["time"]=>
#   int(1747335102)
# }
# ====================================================================================
# encrypt: 'appid=1001&channel=11&extension={"username":"meteorcat","password":"password"}&time=1747335102'
# ====================================================================================
# encryptWithKey: 'appid=1001&channel=11&extension={"username":"meteorcat","password":"password"}&time=1747335102c53d93bafeb52c0be562613daef647de'
# ====================================================================================
# sign: '5ad78915353f59639729cb535dd95fdf'
# ====================================================================================
# array(5) {
#  ["appid"]=>
#  int(1001)
#  ["channel"]=>
#  int(11)
#  ["extension"]=>
#  string(46) "{"username":"meteorcat","password":"password"}"
#  ["time"]=>
#  int(1747335102)
#  ["sign"]=>
#  string(32) "5ad78915353f59639729cb535dd95fdf"
# }
# ====================================================================================

{
  // 其他都是不同对应类型失败, 400 为默认失败
  "state": 200,
  // 响应结构体, 如果非 200 响应就 null, 200 成功就是对象组
  "data": {
    // 作为发行生成的落地在数据库唯一id(long)
    "uid": 10001,
    // 作为发行生成的落地在数据库的用户名，比如 10001.wechat,10001.qq,10001.tiktok,....(格式:uid.渠道简称)
    "username": "meteorcat",
    // 第三方渠道验证成功返回的用户标识唯一ID(比如微信openid), 有的渠道需要第三方渠道这些信息
    "sdkUid": "oaKk343WOktAaT2ygsX138BGblrg",
    // 第三方渠道验证可能会返回在该平台的昵称, 用于设置默认的用户帐号名
    "sdkUsername": "MeteorCat",
    // 当前授权登陆的唯一凭证, 可以md5处理即可
    token: "",
    // 特殊的扩展字段, 有些平台可能后续会用到的参数可以放置其中用 JSON 返回
    extension: "{}",
  }
}

// 这里按照 notifyUrl 回调给 CP 方
{
  // 200 代表成功, 其他为失败
  "status": 200,
  // 200 该字段为对象组, 其他为 null
  "data": {
    // 作为游戏应用的ID
    "appid": 1001,
    // 作为我们发行方的唯一标识ID
    "uid": 10001,
    // 第三方渠道标识, 比如 微信 = 10, QQ = 12, ....
    "channel": 10,
    // 发行游戏订单id, 需要区分 1.发行订单ID 2.第三方订单ID 3.CP订单ID
    "sdkOrderId": 2025051603555501,
    // 玩家角色所属服务器ID
    "serverId": "1",
    // 玩家购买的道具标识
    "orderItem": "104",
    // 玩家支付金额, 单位为分
    "amount": 600,
    // CP方请求推送过来的扩展参数原样返回, 用于 CP 自己去提取对应参数
    extension: "{}",
    // 用于CP验证用 appSecret 参数哈希匹配
    sign: "1e20f28a33fcbb27ded35c9425e18aff",
  }
}