XboxLiveQualityOfServiceMeasurement.PublishPrivatePayloadBytes(Byte[]) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Legt die private Nutzlast fest, die zurückgegeben wird, wenn ein Remotehost die private Nutzlast abfragt.
Wichtig
Diese API ist nicht für alle Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
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())Parameter
- payload
-
Byte[]
byte[]
Die Nutzlast, die veröffentlicht werden soll, wenn dieser Host nach der privaten Nutzlast abgefragt wird. Der MaxPrivatePayloadSize-Eigenschaftswert gibt die maximal zulässige Größe der privaten Nutzlast in Bytes an.
Hinweise
Die veröffentlichten privaten Nutzlastdaten werden von Ihrer App verwendet, um den app-spezifischen Zustand des aktuell ausgeführten Spiels zu übergeben, ohne eine XboxLiveEndpointPair zu erstellen. Beispiele hierfür sind die Anzahl der im Spiel verfügbaren Slots oder die in der aktuellen Runde noch vorhandene Zeit.
Private Nutzlastdatenbytes werden von XboxLiveQualityOfServiceMeasurement-Objekten nicht interpretiert oder überprüft. Sie werden unverändert übertragen. Wie bei allen Nachrichten, die über das Netzwerk mit Remotegeräten ausgetauscht werden, sollten Apps beachten, dass das Remotegerät, das die private Nutzlast veröffentlicht oder empfängt, möglicherweise nicht dieselbe Version der App ausführt, die lokal ausgeführt wird. Erwägen Sie die Verwendung eines Versionsschemas, und überprüfen Sie immer, ob eine Nutzlast wohlgeformt ist, bevor Sie darauf reagieren.