Class
caplin.streamlink

RecordType1Event

Provides information about a change to type 1 data (fieldname and data pairs) in a record.

The RecordType1Event is provided in an onRecordUpdate callback to a caplin.streamlink.SubscriptionListener.

Constructor Summary

Attributes Name and Description
caplin.streamlink.RecordType1Event()

Method Summary

Attributes Name and Description
Object getFields()

Returns the record fields relating to the event, as a collection of key-value pairs.

long getLatency(String timeStampField)

Gets the latency of the record in milliseconds.

long getTimeReceived()

Returns the time that the record data in the event was received at the client.

Methods inherited from class caplin.streamlink.DataEvent:
getSubject, isImage

Constructor Detail

caplin.streamlink.RecordType1Event()

Method Detail

Object getFields()

Returns the record fields relating to the event, as a collection of key-value pairs.

When a call to isImage() returns true, the subscription data event contains an image of the data for the subscribed item. All the fields comprising the record are present in the collection. The application must discard any values previously received and replace them with the values contained within the collection.

When a call to isImage() returns false, the subscription data event contains new data for the subscribed record. The values in the collection returned are an update to any values previously received and any application caches should be updated appropriately.

Returns
{Object} the fields

long getLatency(String timeStampField)

Gets the latency of the record in milliseconds. StreamLink calculates the latency using the clock offset and the timestamp supplied in the timeStampField field of the record.

The latency cannot be calculated if timeStampField is not present in the record or if the clock offset has not yet been established.

Parameters
String timeStampField The name of the field in the record containing the timestamp that StreamLink uses to calculate the latency of the record.
Returns
{long} The latency of the record in milliseconds, or -1 if the latency cannot be calculated.

long getTimeReceived()

Returns the time that the record data in the event was received at the client.

Returns
{long} The time that the record data was received at the client in milliseconds since 1 January 1970 00:00:00 UTC.