XboxLiveQualityOfServiceMeasurement.PublishPrivatePayloadBytes(Byte[]) Metodo

Definizione

Spazio dei nomi:

Windows.Networking.XboxLive

Imposta il payload privato restituito quando un host remoto esegue query per il payload privato.

Importante

Questa API non è disponibile per tutte le app. A meno che il provisioning dell'account per sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.

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())

Parametri

payload

Byte[]

byte[]

Payload da pubblicare quando viene eseguita una query su questo host per il payload privato. Il valore della proprietà MaxPrivatePayloadSize specifica le dimensioni massime consentite del payload privato, in byte.

Commenti

I dati di payload privati pubblicati vengono usati dall'app per passare lo stato specifico dell'app sul gioco attualmente in esecuzione senza creare un oggetto XboxLiveEndpointPair. Gli esempi possono essere: numero di slot disponibili nel gioco o tempo lasciato nel round corrente.

I byte di dati del payload privato non vengono interpretati o convalidati dagli oggetti XboxLiveQualityOfServiceMeasurement . Vengono trasmessi così come sono. Come per tutti i messaggi scambiati con dispositivi remoti in rete, le app devono tenere presente che la pubblicazione del dispositivo remoto o la ricezione del payload privato potrebbe non eseguire la stessa versione dell'app in esecuzione in locale. Prendere in considerazione l'uso di uno schema di controllo delle versioni e verificare sempre che un payload sia ben formato prima di agire su di esso.