Interface IQosService

An interface that allows access to QoS measurements. Your game code should use this interface through QosService.Instance.

Namespace: Unity.Services.Qos

Syntax

public interface IQosService

Methods

GetAllServersAsync()

Declaration

Task<IList<QosServer>> GetAllServersAsync()

Returns

Type	Description
Task<IList<QosServer>>

GetQosResultsAsync(IList<QosServer>)

Gets the QoS measurements associated with each given servers.

Declaration

Task<IList<(QosServer, IQosMeasurements)>> GetQosResultsAsync(IList<QosServer> servers)

Parameters

Type	Name	Description
IList<QosServer>	servers

Returns

Type	Description
Task<IList<(T1, T2)<QosServer, IQosMeasurements>>>

Remarks

No sorting or grouping is done. An empty list will be returned if one of the server is invalid.

GetSortedMultiplayQosResultsAsync(IList<String>)

Gets sorted QoS measurements for Multiplay service.

Declaration

Task<IList<IQosAnnotatedResult>> GetSortedMultiplayQosResultsAsync(IList<string> fleet)

Parameters

Type	Name	Description
IList<String>	fleet	The fleet to query for QoS. GetSortedMultiplayQosResultsAsync only uses QoS servers in the regions of the fleet for measurements. At least one fleet ID must be passed

Returns

Type	Description
Task<IList<IQosAnnotatedResult>>	Returns the sorted list of QoS results, ordered from best to worst.

Remarks

The fleet ID must be a valid Multiplay fleet ID.

GetSortedQosResultsAsync(String, IList<String>)

Gets sorted QoS measurements the specified service and regions.

Declaration

Task<IList<IQosResult>> GetSortedQosResultsAsync(string service, IList<string> regions)

Parameters

Type	Name	Description
String	service	The service to query regions for QoS. GetSortedQosResultsAsync only uses measures regions configured for the specified service.
IList<String>	regions	The regions to query for QoS. If not null or empty, GetSortedQosResultsAsync only uses regions in the intersection of the specified service and the specified regions for measurements.

Returns

Type	Description
Task<IList<IQosResult>>	Returns the sorted list of QoS results, ordered from best to worst.

Remarks

GetSortedQosResultsAsync doesn't consider the returned regions until applying the services and regions filters.

If you specify regions, it only includes those regions.

GetSortedRelayQosResultsAsync(IList<String>)

Gets sorted QoS measurements for Relay service.

Declaration

Task<IList<IQosAnnotatedResult>> GetSortedRelayQosResultsAsync(IList<string> regions)

Parameters

Type	Name	Description
IList<String>	regions	The regions to query for QoS. If not null or empty, GetSortedRelayQosResultsAsync only uses the specified regions for measurements.

Returns

Type	Description
Task<IList<IQosAnnotatedResult>>	Returns the sorted list of QoS results, ordered from best to worst.

Remarks

If you specify regions, it only includes those regions.