游戏服务接入指南

mViewModel = new GameViewModel(mWebView);
mWebView.addJavascriptInterface(mViewModel, "GameJSBridgeAndroid");

// 添加消息处理，其中onMessageFromGame和onCallbackMessage是必须的
userContentController.add(context.coordinator, name: "onMessageFromGame")
userContentController.add(context.coordinator, name: "onCallbackMessage")

// 在Coordinator的userContentController方法中，将消息传递给GameViewModel
func userContentController(_ userContentController: WKUserContentController, didReceive message: WKScriptMessage) {
    parent.viewModel.userContentController(name: message.name,body: "\(message.body)")
}

{
    "results": IResult[], // 玩家信息列表
    "reason": number,     // 游戏结束原因 0: 正常结束  3: 提前结束
    "roundId": string,    // 局id
    "chessNum": number,   // 当局玩法棋子个数 4 或者 2
    "item": number,       // 当局游戏是否有道具 0：无 1：有
    "model": number       // 当局游戏是快速模式还是经典模式 0：快速 1：经典
}

interface IResult{
    uid: string,
    appId: string,
    userId: string,    // 对应app侧的玩家id    
    name: string,
    avatar: string,
    gender: string,
    score: number,    // 得分
    rank: number,
    isEscaped: number,
    isAI: number,
    isManaged: number, // 是否托管完成游戏 1：托管完成 0：不是托管完成
    extras: string,
}

POST 业务侧提供URL
Accept: application/json  
Content-Type: application/json

{ 
    "event": "{{game_event}}", 
    "notify_id": "{{notify_id}}", 
    "game_name": "{{game_name}}", 
    "app_id": "{{app_id}}", 
    "room_id": "{{room_id}}", 
    "timestamp":"{{timestamp}}", 
    "data": {} 
}

{
    "ret_code": 0,
    "ret_msg": "",
    "data": null
}

{ 
    // 通用字段
    "event": "game_start", 
    ...
    "data": {
        "mode": 1,
        "round_id": "{{round_id}}",
        "start_time": 11230182038080,
        "players": [{
            "user_id": "{{user_id}}",
            "seat_index": 0,
            "status": "IDLE",
            "is_ai": 0
        }],
        "extras": "",
        "app_extras": ""
    } 
}

{ 
    // 通用字段
    "event": "game_end", 
    ...
    "data": {
        "mode": 1,
        "round_id": "{{round_id}}",
        "start_time": 11230182038080,
        "end_time": 11230182038080,
        "duration": 5000,
        "results": [{
            "user_id": "{{user_id}}",
            "is_ai": 0,
            "rank": 1,
            "score": 10,
            "is_win": 1,
            "is_escaped": 0,
            "is_managed": 0,
            "extras": ""
        }],
        "extras": "",
        "app_extras": ""
    } 
}

{{app_id}}\n
{{timestamp}}\n
{{nonce}}\n
{{body}}\n

sign = hmac_sha1(origin, secret)

POST url
Authorization: {{auth_type}} app_id="{{app_id}}",timestamp={{timestamp}},nonce={{nonce}},signature={{sign}}

123456
1718777147021
wHwZk4veHDFSpiw5
{"event":"user_enter","app_id":"123456","room_id":"200071","timestamp":"1718777146975","data":{"user_info":{"user_id":"200001","avatar":"https://gfs-static.cyouth.cn/upload/avatar/133482529220956160.png","name":"CYouth","gender":"0","is_ai":0}}}

# 最后一行也有换行符\n

sign = hmac_sha1(origin, secret)
# secret = abcdef
# sign = 24e819bb9a6bac0c02f141e0ff41ed1bf342db79

Authorization: gfs app_id="123456",timestamp="1718777147021",nonce="wHwZk4veHDFSpiw5",signature="24e819bb9a6bac0c02f141e0ff41ed1bf342db79"

POST {{baseURL}}/{game}/app_event
Accept: application/json
Content-Type: application/json

{  
    "event": "user_enter",  
    "app_id": "app_id_1",  
    "room_id": "room_id_1",  
    "timestamp": "1657770493152",  
    "data": {}
}

{
    "event": "user_enter",
    "app_id": "{{app_id}}",
    "room_id": "{{room_id}}",
    "timestamp": "{{timestamp}}",
    "data": {
        "user_info": {
            "user_id": "",
            "avatar": "",
            "name": "",
            "gender": "",
            "extra": ""
        }
    }
}

{  
    // 通用字段
    "event": "game_end",  
    "app_id": "{{app_id}}",  
    "room_id": "{{room_id}}",  
    "timestamp": "{{timestamp}}",
    "data": {  
        "user_id": ""
    }
}

{  
    // 通用字段
    "event": "ai_add",  
    "app_id": "{{app_id}}",  
    "room_id": "{{room_id}}",  
    "timestamp": "{{timestamp}}",
    "data": {  
        "user_infos": [
            {
                "user_id": "",
                "avatar": "",
                "name": "",
                "gender": "",
                "extra": ""
            }
        ],
        "is_ready": true
    }
}