XboxLiveQualityOfServiceMeasurement.PublishPrivatePayloadBytes(Byte[]) 方法

定义

设置远程主机查询专用有效负载时返回的专用有效负载。

重要

此 API 并非适用于所有应用。 除非你的开发人员帐户由 Microsoft 专门预配,否则对这些 API 的调用将在运行时失败。

public:
 static void PublishPrivatePayloadBytes(Platform::Array <byte> ^ payload);
 static void PublishPrivatePayloadBytes(winrt::array_view <byte> const& payload);
public static void PublishPrivatePayloadBytes(byte[] payload);
function publishPrivatePayloadBytes(payload)
Public Shared Sub PublishPrivatePayloadBytes (payload As Byte())

参数

payload

Byte[]

byte[]

查询此主机以获取专用有效负载时要发布的有效负载。 MaxPrivatePayloadSize 属性值指定允许的最大专用有效负载大小(以字节为单位)。

注解

你的应用将使用发布的专用有效负载数据传递有关当前正在运行的游戏的应用特定状态,而无需创建 XboxLiveEndpointPair。 例如:游戏中可用的槽数,或当前回合的剩余时间。

专用有效负载数据字节不会由 XboxLiveQualityOfServiceMeasurement 对象解释或验证。 它们按原样传输。 与通过网络与远程设备交换的所有消息一样,应用应注意,发布或接收专用有效负载的远程设备可能运行的不是本地运行的相同版本的应用。 请考虑使用版本控制方案,并在执行操作之前始终检查有效负载的格式良好。

适用于