Skip to main content

Class: SimVarPublisher<Events, IndexedEventRoots>

Defined in: src/sdk/instruments/BasePublishers.ts:148

A base class for publishers that need to handle simvars with built-in support for pacing callbacks.

Extends

Extended by

Type Parameters

Type ParameterDefault type
Events extends Record<string, any>-
IndexedEventRoots extends Record<string, any>Events

Constructors

Constructor

new SimVarPublisher<Events, IndexedEventRoots>(entries, bus, pacer?): SimVarPublisher<Events, IndexedEventRoots>

Defined in: src/sdk/instruments/BasePublishers.ts:163

Creates a new instance of SimVarPublisher.

Parameters

ParameterTypeDescription
entriesIterable<readonly [keyof Events | keyof IndexedEventRoots & string, SimVarPublisherEntry<any>]>Entries describing the SimVars to publish.
busEventBusThe event bus to which to publish.
pacer?PublishPacer<Events>An optional pacer to control the rate of publishing.

Returns

SimVarPublisher<Events, IndexedEventRoots>

Overrides

BasePublisher.constructor

Properties

bus

protected readonly bus: EventBus

Defined in: src/sdk/instruments/BasePublishers.ts:10

Inherited from

BasePublisher.bus


indexedSimVars

protected readonly indexedSimVars: Map<keyof IndexedEventRoots & string, IndexedSimVarPublisherEntry<any>>

Defined in: src/sdk/instruments/BasePublishers.ts:153


pacer

protected readonly pacer: undefined | PublishPacer<Events>

Defined in: src/sdk/instruments/BasePublishers.ts:13

Inherited from

BasePublisher.pacer


publishActive

protected publishActive: boolean

Defined in: src/sdk/instruments/BasePublishers.ts:12

Inherited from

BasePublisher.publishActive


publisher

protected readonly publisher: Publisher<Events>

Defined in: src/sdk/instruments/BasePublishers.ts:11

Inherited from

BasePublisher.publisher


resolvedSimVars

protected readonly resolvedSimVars: Map<keyof Events & string, ResolvedSimVarPublisherEntry<any>>

Defined in: src/sdk/instruments/BasePublishers.ts:151


subscribed

protected readonly subscribed: Map<keyof Events & string, ResolvedSimVarPublisherEntry<any>>

Defined in: src/sdk/instruments/BasePublishers.ts:155


INDEXED_REGEX

protected readonly static INDEXED_REGEX: RegExp

Defined in: src/sdk/instruments/BasePublishers.ts:149

Methods

getValue()

protected getValue<K>(topic): undefined | Events[K]

Defined in: src/sdk/instruments/BasePublishers.ts:328

Gets the current value for a topic.

Type Parameters

Type Parameter
K extends string

Parameters

ParameterTypeDescription
topicKA topic.

Returns

undefined | Events[K]

The current value for the specified topic.


getValueFromEntry()

protected getValueFromEntry<T>(entry): T

Defined in: src/sdk/instruments/BasePublishers.ts:342

Gets the current value for a resolved topic entry.

Type Parameters

Type Parameter
T

Parameters

ParameterTypeDescription
entryResolvedSimVarPublisherEntry<T>An entry for a resolved topic.

Returns

T

The current value for the specified entry.


handleSubscribedTopic()

protected handleSubscribedTopic(topic): void

Defined in: src/sdk/instruments/BasePublishers.ts:197

Handles when an event bus topic is subscribed to for the first time.

Parameters

ParameterTypeDescription
topicstringThe subscribed topic.

Returns

void


isPublishing()

isPublishing(): boolean

Defined in: src/sdk/instruments/BasePublishers.ts:45

Tells whether or not the publisher is currently active.

Returns

boolean

True if the publisher is active, false otherwise.

Inherited from

BasePublisher.isPublishing


onTopicSubscribed()

protected onTopicSubscribed(topic): void

Defined in: src/sdk/instruments/BasePublishers.ts:283

Responds to when one of this publisher's topics is subscribed to for the first time.

Parameters

ParameterTypeDescription
topickeyof Events & stringThe topic that was subscribed to.

Returns

void


onUpdate()

onUpdate(): void

Defined in: src/sdk/instruments/BasePublishers.ts:300

Publish all subscribed data points to the bus.

Returns

void

Overrides

BasePublisher.onUpdate


publish()

protected publish<K>(topic, data, sync, isCached): void

Defined in: src/sdk/instruments/BasePublishers.ts:63

Publish a message if publishing is acpive

Type Parameters

Type Parameter
K extends string | number | symbol

Parameters

ParameterTypeDefault valueDescription
topicKundefinedThe topic key to publish to.
dataEvents[K]undefinedThe data type for chosen topic.
syncbooleanfalseWhether or not the event should be synced to other instruments. Defaults to false.
isCachedbooleantrueWhether or not the event should be cached. Defaults to true.

Returns

void

Inherited from

BasePublisher.publish


publishTopic()

protected publishTopic(topic, entry): void

Defined in: src/sdk/instruments/BasePublishers.ts:311

Publishes data to the event bus for a topic.

Parameters

ParameterTypeDescription
topickeyof Events & stringThe topic to publish.
entryundefined | ResolvedSimVarPublisherEntry<any>The entry corresponding to the topic

Returns

void


resolveIndexedSimVar()

protected resolveIndexedSimVar(topic, entry, index): undefined | string

Defined in: src/sdk/instruments/BasePublishers.ts:254

Attempts to resolve an indexed topic with an index, generating a version of the topic which is mapped to an indexed simvar. The resolved indexed topic can then be published.

Parameters

ParameterTypeDescription
topickeyof IndexedEventRoots & stringThe topic to resolve.
entryIndexedSimVarPublisherEntry<any>The entry of the topic to resolve.
indexnumberThe index with which to resolve the topic. If not defined, the topic will resolve to itself (without a suffix) and will be mapped the index-1 version of its simvar.

Returns

undefined | string

The resolved indexed topic, or undefined if the topic could not be resolved with the specified index.


startPublish()

startPublish(): void

Defined in: src/sdk/instruments/BasePublishers.ts:30

Start publishing.

Returns

void

Inherited from

BasePublisher.startPublish


stopPublish()

stopPublish(): void

Defined in: src/sdk/instruments/BasePublishers.ts:37

Stop publishing.

Returns

void

Inherited from

BasePublisher.stopPublish


tryMatchIndexedSubscribedTopic()

protected tryMatchIndexedSubscribedTopic(topic): void

Defined in: src/sdk/instruments/BasePublishers.ts:212

Checks if a subscribed topic matches one of this publisher's indexed topics, and if so resolves and starts publishing the indexed topic.

Parameters

ParameterTypeDescription
topicstringThe subscribed topic to check.

Returns

void