XboxLiveQualityOfServiceMeasurement.PublishedPrivatePayload Eigenschaft
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.
Ruft die private Nutzlast ab, die für das lokale Gerät veröffentlicht wurde, oder legt diese fest.
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 property IBuffer ^ PublishedPrivatePayload { IBuffer ^ get(); void set(IBuffer ^ value); };static IBuffer PublishedPrivatePayload();
static void PublishedPrivatePayload(IBuffer value);public static IBuffer PublishedPrivatePayload { get; set; }var iBuffer = XboxLiveQualityOfServiceMeasurement.publishedPrivatePayload;
XboxLiveQualityOfServiceMeasurement.publishedPrivatePayload = iBuffer;Public Shared Property PublishedPrivatePayload As IBufferEigenschaftswert
Die lokale private Nutzlast.
Hinweise
Der Puffer darf MaxPrivatePayloadSize in Bytes nicht überschreiten.
Die private Nutzlast wird von Ihrer App verwendet, um den app-spezifischen Zustand des derzeit ausgeführten Spiels zu übergeben, ohne eine XboxLiveEndpointPair zu erstellen. Ein Beispiel könnte sein: Anzahl der im Spiel verfügbaren Slots oder zeit in der aktuellen Runde.
Private Nutzlastdatenbytes werden von XboxLiveQualityOfServiceMeasurement-Objekten nicht interpretiert oder überprüft. Sie werden unverändert übertragen. Wie bei allen Nachrichten, die mit Remotegeräten über das Netzwerk ausgetauscht werden, sollten Apps beachten, dass auf dem Remotegerät, das die private Nutzlast veröffentlicht oder empfängt, möglicherweise nicht dieselbe Version der lokal ausgeführten App ausgeführt wird. Erwägen Sie die Verwendung eines Versionsverwaltungsschemas, und überprüfen Sie immer, ob eine Nutzlast wohlgeformt ist, bevor Sie darauf reagieren.