PartyEndpointStatistic

项目
07/11/2023

可检索到终结点的统计信息类型。

语法

enum class PartyEndpointStatistic    
{  
    CurrentlyQueuedSendMessages = 0,  
    CurrentlyQueuedSendMessageBytes = 1,  
    CurrentlyActiveSendMessages = 2,  
    CurrentlyActiveSendMessageBytes = 3,  
    TimedOutSendMessages = 4,  
    TimedOutSendMessageBytes = 5,  
    CanceledSendMessages = 6,  
    CanceledSendMessageBytes = 7,  
    AverageDeviceRoundTripLatencyInMilliseconds = 8,  
}

常量

常量	说明
CurrentlyQueuedSendMessages	当前由 PartyLocalEndpoint::SendMessage() 排队但尚未从本地终结点传输到指定目标终结点的消息数量。为了提高效率，在通过透明云中继服务器一次向多个目标终结点发送时，PartyLocalEndpoint::SendMessage() 仅将一条消息排入队列。如果在查询该统计数据时，向 PartyLocalEndpoint::GetEndpointStatistics() 指定了两个或更多的这些终结点，那么该消息将仅计算一次，而不是每个目标终结点相乘。
CurrentlyQueuedSendMessageBytes	当前由 PartyLocalEndpoint::SendMessage() 排队但尚未从本地终结点传送到指定目标终结点的消息中的数据字节数。为了提高效率，在通过透明云中继服务器一次向多个目标终结点发送时，PartyLocalEndpoint::SendMessage() 仅将一条消息排入队列。如果在查询该统计数据时，向 PartyLocalEndpoint::GetEndpointStatistics() 指定了两个或更多的这些终结点，那么该消息字节将仅计算一次，而不是每个目标终结点相乘。
CurrentlyActiveSendMessages	从本地终结点到指定的目标终结点的 PartyLocalEndpoint::SendMessage() 消息的数量，这些消息目前正在传输或仍有更多本地状态变化需要处理。一旦消息的第一个字节放入正在传输的数据包中，该消息就视为“有效”。它始终处于活动状态，直到传输完成，并且它的本地 PartyDataBuffersReturnedStateChange (如果适用) 已经返回给 PartyManager::FinishProcessingStateChanges()。为了提高效率，在通过透明云中继服务器一次向多个目标终结点发送时，PartyLocalEndpoint::SendMessage() 仅跟踪一条消息。如果在查询该统计数据时，向 PartyLocalEndpoint::GetEndpointStatistics() 指定了两个或更多的这些终结点，那么该消息将仅计算一次，而不是每个目标终结点相乘。
CurrentlyActiveSendMessageBytes	从本地终结点到指定的目标终结点的 PartyLocalEndpoint::SendMessage() 消息中，目前正在传输或仍有更多本地状态变化需要处理的数据字节数。一旦消息的第一个字节放入正在传输的数据包中，该消息就视为“有效”。它始终处于活动状态，直到传输完成，并且它的本地 PartyDataBuffersReturnedStateChange (如果适用) 已经返回给 PartyManager::FinishProcessingStateChanges()。为了提高效率，在通过透明云中继服务器一次向多个目标终结点发送时，PartyLocalEndpoint::SendMessage() 仅跟踪一条消息。如果在查询该统计数据时，向 PartyLocalEndpoint::GetEndpointStatistics() 指定了两个或更多的这些终结点，那么该消息字节将仅计算一次，而不是每个目标终结点相乘。
TimedOutSendMessages	从本地终结点到指定目标终结点的 PartyLocalEndpoint::SendMessage() 消息的总数，这些消息曾因超过发送队列的超时而遭到丢弃，没有传送。在调用 PartyLocalEndpoint::SendMessage() 时，使用 PartySendMessageQueuingConfiguration::timeoutInMillseconds 指定消息的发送队列超时。为了提高效率，在通过透明云中继服务器一次向多个目标终结点发送时，PartyLocalEndpoint::SendMessage() 仅将一条消息排入队列。如果在查询该统计数据时，向 PartyLocalEndpoint::GetEndpointStatistics() 指定了两个或更多的这些终结点，那么该消息将仅计算一次，而不是每个目标终结点相乘。当通过向 PartyLocalEndpoint::GetEndpointStatistics() 提供一个零条目数组来查询所有目标终结点的这一统计数据时，请注意仅包括当前存在的终结点在内。如果一个已经超时的消息终结点在查询之间销毁，该计数则可能认为是“倒退”了。
TimedOutSendMessageBytes	从本地终结点到指定目标终结点的 PartyLocalEndpoint::SendMessage() 消息中，曾经因超过其发送队列超时而遭到丢弃，未传送的数据字节总数。在调用 PartyLocalEndpoint::SendMessage() 时，使用 PartySendMessageQueuingConfiguration::timeoutInMillseconds 指定消息的发送队列超时。为了提高效率，在通过透明云中继服务器一次向多个目标终结点发送时，PartyLocalEndpoint::SendMessage() 仅将一条消息排入队列。如果在查询该统计数据时，向 PartyLocalEndpoint::GetEndpointStatistics() 指定了两个或更多的这些终结点，那么该消息字节将仅计算一次，而不是每个目标终结点相乘。当通过向 PartyLocalEndpoint::GetEndpointStatistics() 提供一个零条目数组来查询所有目标终结点的这一统计数据时，请注意仅包括当前存在的终结点在内。如果一个已经超时的消息终结点在查询之间销毁，该计数则可能认为是“倒退”了。
CanceledSendMessages	从本地终结点到指定目标终结点的曾遭到取消的 PartyLocalEndpoint::SendMessage() 消息总数。在具有匹配的筛选表达式的应用程序调用 PartyLocalEndpoint::CancelMessages() 传送消息之前将其取消。为了提高效率，在通过 PartyNetwork 透明云中继服务器同时向多个目标终结点发送时，PartyLocalEndpoint::SendMessage() 仅排队发送一条消息。如果在查询该统计数据时，向 PartyLocalEndpoint::GetEndpointStatistics() 指定了两个或更多的这些终结点，那么该消息将仅计算一次，而不是每个目标终结点相乘。当通过向 PartyLocalEndpoint::GetEndpointStatistics() 提供一个零条目数组来查询所有目标终结点的这一统计数据时，请注意仅包括当前存在的终结点在内。如果一个取消了消息的终结点在查询之间遭到销毁，该计数可能认为是“倒退”了。
CanceledSendMessageBytes	从本地终结点到指定目标终结点的 PartyLocalEndpoint::SendMessage() 消息中曾经遭到取消的数据字节总数。在具有匹配的筛选表达式的应用程序调用 PartyLocalEndpoint::CancelMessages() 传送消息之前将其取消。为了提高效率，在通过 PartyNetwork 透明云中继服务器同时向多个目标终结点发送时，PartyLocalEndpoint::SendMessage() 仅排队发送一条消息。如果在查询该统计数据时，向 PartyLocalEndpoint::GetEndpointStatistics() 指定了两个或更多的这些终结点，那么该消息字节将仅计算一次，而不是每个目标终结点相乘。当通过向 PartyLocalEndpoint::GetEndpointStatistics() 提供一个零条目数组来查询所有目标终结点的这一统计数据时，请注意仅包括当前存在的终结点在内。如果一个取消了消息的终结点在查询之间遭到销毁，该计数可能认为是“倒退”了。
AverageDeviceRoundTripLatencyInMilliseconds	当前移动平均往返延迟 (“ping 时间”) 到终结点拥有的设备，以毫秒为单位。该延迟代表了目前这饿本地设备发送消息并从目标终结点的设备接收响应所需时间的移动平均值。该统计数字一次仅能精确地查询到一个目标终结点。如果提供了多个目标，或者提供了一个零入口数组来试图查询所有当前的终结点，那么 PartyLocalEndpoint::GetEndpointStatistics() 方法将失败。也可以通过使用 PartyNetwork::GetNetworkStatistics() 来检索 PartyNetworkStatistic::AverageRelayServerRoundTripLatencyInMilliseconds 的统计数据来确定本地设备到网络的透明云中继服务器的平均往返延迟。

要求

标题： Party.h

另请参阅

群成员
 PartyNetworkStatistic
PartySendMessageQueuingConfiguration
PartyLocalEndpoint::SendMessage
PartyLocalEndpoint::GetEndpointStatistics
PartyNetwork::GetNetworkStatistics

通过

PartyEndpointStatistic

语法

常量

要求

另请参阅

反馈

其他资源