PartyNetworkStatistic - XBOX Game Development Documentation

可為網路擷取的統計資料類型。

語法

enum class PartyNetworkStatistic    
{  
    AverageRelayServerRoundTripLatencyInMilliseconds = 0,  
    SentProtocolPackets = 1,  
    SentProtocolBytes = 2,  
    RetriedProtocolPackets = 3,  
    RetriedProtocolBytes = 4,  
    DroppedProtocolPackets = 5,  
    ReceivedProtocolPackets = 6,  
    ReceivedProtocolBytes = 7,  
    CurrentlyQueuedSendMessages = 8,  
    CurrentlyQueuedSendMessageBytes = 9,  
    CurrentlyActiveSendMessages = 10,  
    CurrentlyActiveSendMessageBytes = 11,  
    TimedOutSendMessages = 12,  
    TimedOutSendMessageBytes = 13,  
    CanceledSendMessages = 14,  
    CanceledSendMessageBytes = 15,  
}  

常數

常數	描述
AverageRelayServerRoundTripLatencyInMilliseconds	與網路之雲端轉送伺服器之間目前的移動平均來回延遲 (「Ping 時間」)，以毫秒為單位。此延遲代表此本機裝置目前傳送訊息並從透明雲端轉送伺服器接收回應所需時間的移動平均。您也可以使用 PartyLocalEndpoint::GetEndpointStatistics() 擷取 PartyEndpointStatistic::AverageDeviceRoundTripLatencyInMilliseconds 統計資料，以判斷特定本機端點與網路中另一個端點之間的平均來回延遲。
SentProtocolPackets	作為此網路的一部分，曾傳輸至遠端裝置的內部通訊協定封包總數。此統計資料代表本機裝置因任何網路原因所傳輸的內部通訊協定封包總數。它包含因 PartyLocalEndpoint::SendMessage() 呼叫而產生的封包，但不一定與這些呼叫一對一對應，因為視設定和環境因素而定，多則小型訊息可能會合併成單一封包，或大型訊息可能會分割成多個封包。此外，封包可能會用於代表應用程式承載聊天或其他內部程式庫功能 (例如 API 作業支援訊息、通訊協定確認或重試)，而不需要明確呼叫 PartyLocalEndpoint::SendMessage()。此統計資料不包含 Party 程式庫在內部用於驗證、管理交易、語音轉文字轉譯和文字轉語音合成等層面之 HTTP Web 用戶端作業所產生的任何封包。
SentProtocolBytes	作為此網路的一部分，曾傳輸至遠端裝置的內部通訊協定位元組總數。此統計資料代表本機裝置因任何網路原因所傳輸之內部通訊協定封包的位元組總數。此大小包含 PartyLocalEndpoint::SendMessage() 承載，以及其內部通訊協定額外負荷，還有代表應用程式在沒有明確呼叫 PartyLocalEndpoint::SendMessage() 的情況下所需的任何聊天或其他內部程式庫功能 (例如 API 作業支援訊息、通訊協定確認或重試)。回報的值不包含網際網路通訊協定 (例如 UDP、IP) 或 Party 程式庫內部通訊協定運作所在之較低層級媒體的封包額外負荷。此統計資料不包含 Party 程式庫在內部用於驗證、管理交易、語音轉文字轉譯和文字轉語音合成等層面之 HTTP Web 用戶端作業所產生之任何封包的大小。
RetriedProtocolPackets	作為此網路的一部分，曾重新傳輸至遠端裝置的內部通訊協定封包總數。此統計資料代表本機裝置因先前嘗試明顯遭受環境遺失而重新傳輸的內部通訊協定封包總數。Party 程式庫只會重試包含以 PartySendMessageOptions::GuaranteedDelivery 傳送之應用程式訊息，或具有類似傳遞需求之內部程式庫訊息的遺失封包。此統計資料不包含 Party 程式庫在內部用於驗證、管理交易、語音轉文字轉譯和文字轉語音合成等層面之 HTTP Web 用戶端作業所產生之封包的任何重試。
RetriedProtocolBytes	作為此網路的一部分，曾重新傳輸至遠端裝置的內部通訊協定位元組總數。此統計資料代表本機裝置因先前嘗試明顯遭受環境遺失而重新傳輸之內部通訊協定封包的位元組總數。此大小包含以 PartySendMessageOptions::GuaranteedDelivery 傳送之應用程式訊息的承載，或具有類似傳遞需求之內部程式庫訊息的承載。回報的值不包含網際網路通訊協定 (例如 UDP、IP) 或 Party 程式庫內部通訊協定運作所在之較低層級媒體的重試封包額外負荷。此統計資料不包含 Party 程式庫在內部用於驗證、管理交易、語音轉文字轉譯和文字轉語音合成等層面之 HTTP Web 用戶端作業所產生之任何重試封包的大小。
DroppedProtocolPackets	傳送至此網路中遠端裝置、被認為已遺失的內部通訊協定封包總數。此統計資料代表本機裝置嘗試傳輸、但似乎遭受環境遺失的內部通訊協定封包傳輸總數。它們不一定已被重試 (請參閱 RetriedProtocolPackets)。此統計資料不包含 Party 程式庫在內部用於驗證、管理交易、語音轉文字轉譯和文字轉語音合成等層面之 HTTP Web 用戶端作業所產生的任何遺失封包。
ReceivedProtocolPackets	作為此網路的一部分，曾從遠端裝置接收的內部通訊協定封包總數。此統計資料代表本機裝置因任何網路原因所接收的內部通訊協定封包總數，它與 PartyEndpointMessageReceivedStateChange 之間並非一對一對應。視設定和環境因素而定，多則小型訊息可能會合併成單一封包，或大型訊息可能會分割成多個封包。此外，封包可能會用於代表應用程式承載聊天或其他內部程式庫功能 (例如 API 作業支援訊息、通訊協定確認或重試)，而不需要明確呼叫 PartyLocalEndpoint::SendMessage()。此統計資料不包含 Party 程式庫在內部用於驗證、管理交易、語音轉文字轉譯和文字轉語音合成等層面之 HTTP Web 用戶端作業所接收的任何封包。
ReceivedProtocolBytes	作為此網路的一部分，曾從遠端裝置接收的內部通訊協定位元組總數。此統計資料代表本機裝置因任何網路原因所接收之內部通訊協定封包的位元組總數。此大小包含 PartyEndpointMessageReceivedStateChange 承載，以及其內部通訊協定額外負荷，還有任何聊天或其他所需的內部程式庫功能 (例如 API 作業支援訊息、通訊協定確認或重試)。回報的值不包含網際網路通訊協定 (例如 UDP、IP) 或 Party 程式庫內部通訊協定運作所在之較低層級媒體的封包額外負荷。此統計資料不包含 Party 程式庫在內部用於驗證、管理交易、語音轉文字轉譯和文字轉語音合成等層面之 HTTP Web 用戶端作業所接收之任何封包的大小。
CurrentlyQueuedSendMessages	目前已由 PartyLocalEndpoint::SendMessage() 排入佇列，但尚未從網路中所有本機端點傳輸至所有遠端端點的訊息數目。為了提高效率，透過透明雲端轉送伺服器一次傳送至多個目標端點時，PartyLocalEndpoint::SendMessage() 只會將單一訊息排入佇列。這類訊息只會計算一次，而不會依目標端點倍增。
CurrentlyQueuedSendMessageBytes	目前已由 PartyLocalEndpoint::SendMessage() 排入佇列，但尚未從網路中所有本機端點傳輸至所有遠端端點之訊息的資料位元組數。為了提高效率，透過透明雲端轉送伺服器一次傳送至多個目標端點時，PartyLocalEndpoint::SendMessage() 只會將單一訊息排入佇列。這類訊息的位元組只會計算一次，而不會依目標端點倍增。
CurrentlyActiveSendMessages	從網路中所有本機端點傳送至所有遠端端點、目前正在傳輸或仍有更多本機狀態變更待處理之 PartyLocalEndpoint::SendMessage() 訊息的數目。一旦訊息的第一個位元組被放入正在傳輸的封包中，該訊息就會被視為「作用中」。它會保持作用中，直到傳輸完成，且其本機 PartyDataBuffersReturnedStateChange (如果適用) 已傳回給 PartyManager::FinishProcessingStateChanges() 為止。為了提高效率，透過透明雲端轉送伺服器一次傳送至多個目標端點時，PartyLocalEndpoint::SendMessage() 只會將單一訊息排入佇列。這類訊息只會計算一次，而不會依目標端點倍增。
CurrentlyActiveSendMessageBytes	從網路中所有本機端點傳送至所有遠端端點、目前正在傳輸或仍有更多本機狀態變更待處理之 PartyLocalEndpoint::SendMessage() 訊息的資料位元組數。一旦訊息的第一個位元組被放入正在傳輸的封包中，該訊息就會被視為「作用中」。它會保持作用中，直到傳輸完成，且其本機 PartyDataBuffersReturnedStateChange (如果適用) 已傳回給 PartyManager::FinishProcessingStateChanges() 為止。為了提高效率，透過透明雲端轉送伺服器一次傳送至多個目標端點時，PartyLocalEndpoint::SendMessage() 只會將單一訊息排入佇列。這類訊息的位元組只會計算一次，而不會依目標端點倍增。
TimedOutSendMessages	從網路中所有本機端點傳送至所有遠端端點、曾因超過其傳送佇列逾時而在未傳輸的情況下被捨棄之 PartyLocalEndpoint::SendMessage() 訊息的總數。訊息的傳送佇列逾時是在呼叫 PartyLocalEndpoint::SendMessage() 時使用 PartySendMessageQueuingConfiguration::timeoutInMillseconds 指定。為了提高效率，透過透明雲端轉送伺服器一次傳送至多個目標端點時，PartyLocalEndpoint::SendMessage() 只會將單一訊息排入佇列。這類訊息只會計算一次，而不會依目標端點倍增。
TimedOutSendMessageBytes	從網路中所有本機端點傳送至所有遠端端點、曾因超過其傳送佇列逾時而在未傳輸的情況下被捨棄之 PartyLocalEndpoint::SendMessage() 訊息的資料總位元組數。訊息的傳送佇列逾時是在呼叫 PartyLocalEndpoint::SendMessage() 時使用 PartySendMessageQueuingConfiguration::timeoutInMillseconds 指定。為了提高效率，透過透明雲端轉送伺服器一次傳送至多個目標端點時，PartyLocalEndpoint::SendMessage() 只會將單一訊息排入佇列。這類訊息的位元組只會計算一次，而不會依目標端點倍增。
CanceledSendMessages	從網路中所有本機端點傳送至所有遠端端點、曾被取消之 PartyLocalEndpoint::SendMessage() 訊息的總數。訊息會在傳輸前由應用程式以相符的篩選運算式呼叫 PartyLocalEndpoint::CancelMessages() 取消。為了提高效率，透過透明雲端轉送伺服器一次傳送至多個目標端點時，PartyLocalEndpoint::SendMessage() 只會將單一訊息排入佇列。這類訊息只會計算一次，而不會依目標端點倍增。
CanceledSendMessageBytes	從網路中所有本機端點傳送至所有遠端端點、曾被取消之 PartyLocalEndpoint::SendMessage() 訊息的資料總位元組數。訊息會在傳輸前由應用程式以相符的篩選運算式呼叫 PartyLocalEndpoint::CancelMessages() 取消。為了提高效率，透過透明雲端轉送伺服器一次傳送至多個目標端點時，PartyLocalEndpoint::SendMessage() 只會將單一訊息排入佇列。這類訊息的位元組只會計算一次，而不會依目標端點倍增。

需求

標頭： Party.h

另請參閱

Party 成員
PartyEndpointStatistic
PartySendMessageOptions
PartyNetwork::GetNetworkStatistics
PartyLocalEndpoint::SendMessage
PartyLocalEndpoint::GetEndpointStatistics

最後修改於 2026年10月8日

⌘I