/**
 * 网络收发包工具类
 * 自动处理平台框架提供的基础数据字段，简化子游戏的网络通信
 * 
 * 功能特性：
 * - 自动注入平台数据：agentid、gameid、playerid、roomcode
 * - 统一的RPC发送接口
 * - 支持调试模式输出
 * - 遵循数据包协议规范
 * 
 * @author GameABC Framework
 * @version 1.0.0
 */

var RpcHelper = {
    
    /**
     * 发送RPC请求
     * 自动注入平台框架提供的基础验证字段
     * 
     * @param {string} app - 应用名称，通常为 "youle"
     * @param {string} route - 路由名称，如 "room"
     * @param {string} rpc - RPC方法名，如 "play_card"
     * @param {Object} gameData - 子游戏业务数据
     * @param {Object} options - 可选配置参数
     * @param {boolean} options.debug - 是否输出调试信息，默认false
     * @param {Object} options.customData - 自定义的额外数据字段
     */
    sendRpc: function(app, route, rpc, gameData, options) {
        // 参数验证
        if (!app || typeof app !== 'string') {
            console.error('RpcHelper.sendRpc: app参数必须是非空字符串');
            return;
        }
        if (!route || typeof route !== 'string') {
            console.error('RpcHelper.sendRpc: route参数必须是非空字符串');
            return;
        }
        if (!rpc || typeof rpc !== 'string') {
            console.error('RpcHelper.sendRpc: rpc参数必须是非空字符串');
            return;
        }
        
        // 默认选项
        options = options || {};
        var debug = options.debug || false;
        var customData = options.customData || {};
        
        // 构建完整的数据包
        var data = {};
        
        // 1. 自动注入平台框架提供的基础验证字段
        try {
            data.agentid = GameData.AgentId;      // 运营商ID（String类型）
            data.gameid = GameData.GameId;        // 游戏类型标识（String类型）
            data.playerid = C_Player.playerid;    // 玩家唯一标识（Number类型）
            data.roomcode = Utl.getRoomcode();    // 房间号（String类型）
        } catch (e) {
            console.error('RpcHelper.sendRpc: 获取平台基础数据失败', e);
            return;
        }
        
        // 2. 验证必需的平台数据
        if (!data.agentid) {
            console.error('RpcHelper.sendRpc: agentid未设置，请确保平台框架已初始化');
            return;
        }
        if (!data.gameid) {
            console.error('RpcHelper.sendRpc: gameid未设置，请确保平台框架已初始化');
            return;
        }
        if (!data.playerid) {
            console.error('RpcHelper.sendRpc: playerid未设置，请确保玩家已登录');
            return;
        }
        if (!data.roomcode) {
            console.error('RpcHelper.sendRpc: roomcode未设置，请确保已进入房间');
            return;
        }
        
        // 3. 合并子游戏业务数据
        if (gameData && typeof gameData === 'object') {
            for (var key in gameData) {
                if (gameData.hasOwnProperty(key)) {
                    data[key] = gameData[key];
                }
            }
        }
        
        // 4. 合并自定义数据
        for (var key in customData) {
            if (customData.hasOwnProperty(key)) {
                data[key] = customData[key];
            }
        }
        
        // 5. 调试信息输出
        if (debug || Game_Config.Debugger.isDebugger) {
            console.log('RpcHelper发送RPC:', {
                app: app,
                route: route,
                rpc: rpc,
                platform_data: {
                    agentid: data.agentid,
                    gameid: data.gameid,
                    playerid: data.playerid,
                    roomcode: data.roomcode
                },
                game_data: gameData,
                custom_data: customData
            });
        }
        
        // 6. 通过框架发送RPC请求
        Utl.sendData(app, route, rpc, data);
    },
    
    /**
     * 发送游戏房间RPC
     * 专门用于游戏房间相关的RPC调用，预设app="youle", route="room"
     * 
     * @param {string} rpc - RPC方法名
     * @param {Object} gameData - 子游戏业务数据
     * @param {Object} options - 可选配置参数
     */
    sendGameRpc: function(rpc, gameData, options) {
        this.sendRpc("youle", "room", rpc, gameData, options);
    },
    
    /**
     * 发送代理商RPC
     * 专门用于代理商相关的RPC调用，预设app="youle", route="agent"
     * 
     * @param {string} rpc - RPC方法名
     * @param {Object} gameData - 子游戏业务数据
     * @param {Object} options - 可选配置参数
     */
    sendAgentRpc: function(rpc, gameData, options) {
        this.sendRpc("youle", "agent", rpc, gameData, options);
    },
    
    /**
     * 发送平台RPC
     * 专门用于平台相关的RPC调用，预设app="youle", route="platform"
     * 
     * @param {string} rpc - RPC方法名
     * @param {Object} gameData - 子游戏业务数据
     * @param {Object} options - 可选配置参数
     */
    sendPlatformRpc: function(rpc, gameData, options) {
        this.sendRpc("youle", "platform", rpc, gameData, options);
    },
    
    /**
     * 获取当前平台数据快照
     * 用于调试和信息查看
     * 
     * @returns {Object} 包含当前平台数据的对象
     */
    getPlatformData: function() {
        try {
            return {
                agentid: GameData.AgentId,
                gameid: GameData.GameId,
                playerid: C_Player.playerid,
                roomcode: Utl.getRoomcode(),
                timestamp: new Date().getTime()
            };
        } catch (e) {
            console.error('RpcHelper.getPlatformData: 获取平台数据失败', e);
            return null;
        }
    },
    
    /**
     * 验证平台数据完整性
     * 检查所有必需的平台数据是否已正确设置
     * 
     * @returns {Object} 验证结果对象 {valid: boolean, missing: Array}
     */
    validatePlatformData: function() {
        var result = {
            valid: true,
            missing: []
        };
        
        try {
            if (!GameData.AgentId) {
                result.valid = false;
                result.missing.push('agentid');
            }
            if (!GameData.GameId) {
                result.valid = false;
                result.missing.push('gameid');
            }
            if (!C_Player.playerid) {
                result.valid = false;
                result.missing.push('playerid');
            }
            if (!Utl.getRoomcode()) {
                result.valid = false;
                result.missing.push('roomcode');
            }
        } catch (e) {
            result.valid = false;
            result.missing.push('platform_error');
            console.error('RpcHelper.validatePlatformData: 验证过程出错', e);
        }
        
        return result;
    }
};

// ES5兼容性：确保在旧版本浏览器中也能正常工作
if (typeof Object.defineProperty === 'function') {
    // 防止意外修改工具类
    Object.defineProperty(window, 'RpcHelper', {
        value: RpcHelper,
        writable: false,
        configurable: false
    });
} else {
    // 旧版本浏览器的兼容处理
    window.RpcHelper = RpcHelper;
}