nn::nex::DataSet::ReliableUpdate Member Function

Syntax

qBool ReliableUpdate() const;

Parameters

None.

Return Values



Value Description
true Returned when this dataset is updated over a reliable channel.
false Returned when this dataset is updated over an unreliable channel.

Description

Returns whether the dataset will be updated using a reliable channel.

Datasets are transferred over a reliable channel (delivery guaranteed) or an unreliable channel (delivery not guaranteed). If a packet is lost on the network when using an unreliable channel for which delivery is not guaranteed, the content will not be sent to the recipient again. The channel used for a dataset is given by the update policy set for that dataset as declared in the data definition language (DDL). By default, updates use a reliable (delivery guaranteed) channel. If the unreliable property is included in the DDL file, an unreliable (delivery not guaranteed) channel is used.

Generally, the transfer cost of reliable communication is high, while the transfer cost of unreliable communication is not high. Although the update frequency is low with reliable communication, use it for information that definitely must go through (player health or items possessed, for example). Although the update frequency is higher with unreliable communication, use it for information that will not cause any significant disruption even if it does not necessarily go through (player coordinates or the direction they are facing, for example).

Revision History

2011/01/27
Initial version.

CONFIDENTIAL