状态与 RPC

功能说明

状态与 RPC 属于联机大厅的子能力。状态用于同步房间内的共享数据或玩家数据；RPC 用于在房间内触发一段命名逻辑。两者都需要在玩家进入房间后使用。

支持引擎

引擎	状态	说明
Unity	Preview	支持状态 set / get / reset 和 RPC register / call / unregister。
GameMaker	暂不支持	当前 GameMaker 首期不包含状态和 RPC。
Godot	开发中	预览 runtime 已有 JSON 状态和 RPC 调用。

前置条件

已完成房间的最小流程。
已进入房间。
状态 key 和 RPC 名称需要保持稳定。

按引擎查看

using System;
using UnityEngine;
using IGP.Multiplayer;

public sealed class IGPStateRpcDriver : MonoBehaviour
{
    [SerializeField] private IGPMultiplayerRuntime runtimeManager;

    public async void SetGlobalScore()
    {
        await runtimeManager.SetGlobalStateAsync("match.score", new
        {
            red = 1,
            blue = 0,
            updatedAt = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds(),
        });
    }

    public async void RegisterEchoRpc()
    {
        await runtimeManager.RegisterRPCAsync("sample.echo");
    }

    public async void CallEchoRpc()
    {
        var requestId = await runtimeManager.CallRPCAsync(
            "sample.echo",
            new { text = "hello" },
            "all");

        Debug.Log($"RPC request id={requestId}");
    }
}

通过 IGPMultiplayerRuntime.MessageReceived 接收状态和 RPC 消息，并按 state_set、state_get、state_reset、rpc_call 或 rpc_response 类型分派。对应的 Content 已由 SDK 转换为 StateSetContent、StateGetResponseContent、StateResetResponseContent、RPCCallContent 或 RPCResponseContent；使用 GetValue<T>() / GetData<T>() 读取游戏数据，不需要解析 JObject。回复 RPC 时使用 RespondRPCAsync，目标玩家传入 RPCCallContent.CallerPlayerId。

using Godot;
using IGP.GodotSDK.Autoload;

public partial class StateRpcPanel : Control
{
    private IGPGodotAutoload IGP =>
        GetNode<IGPGodotAutoload>("/root/IGP");

    public async void SetGlobalScore()
    {
        await IGP.SetStateJsonAsync(
            "global",
            "match.score",
            "{\"red\":1,\"blue\":0}");
    }

    public async void RegisterEchoRpc()
    {
        await IGP.RegisterRpcAsync("sample.echo");
    }

    public async void CallEchoRpc()
    {
        await IGP.CallRpcJsonAsync(
            "sample.echo",
            "{\"text\":\"hello\"}",
            "all");
    }
}

自测方式

引擎	检查点
Unity	设置状态后能收到状态变化；注册 RPC 后能调用并收到响应。
GameMaker	当前不做状态与 RPC 验收。
Godot	`SetStateJsonAsync`、`GetStateAsync`、`CallRpcJsonAsync` 能顺序完成。

常见问题 / 排查

无法读取状态：确认 scope 和 key 完全一致。
RPC 未触发：先确认已经注册对应 RPC 名称。
Unity 未收到事件：确认已监听 IGPMultiplayerRuntime.MessageReceived，并检查收到的 MessageType。
Godot JSON 失败：先用简单对象字符串验证，例如 {"value":1}。