@signageos/front-applet 8.1.3 → 8.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/bundle.js.map +1 -1
- package/docs/sos/browser.md +17 -17
- package/docs/sos/command.md +6 -6
- package/docs/sos/debug.md +7 -3
- package/docs/sos/deviceInfo.md +6 -2
- package/docs/sos/display.md +3 -3
- package/docs/sos/fileSystem.md +67 -67
- package/docs/sos/hardware/barcodeScanner.md +58 -15
- package/docs/sos/hardware/index.md +72 -15
- package/docs/sos/hardware/led.md +32 -3
- package/docs/sos/index.md +3 -3
- package/docs/sos/input.md +7 -7
- package/docs/sos/monitors.md +8 -0
- package/docs/sos/native/mdc.md +9 -9
- package/docs/sos/offline/cache.md +368 -28
- package/docs/sos/offline/index.md +127 -24
- package/docs/sos/osd.md +8 -1
- package/docs/sos/proofOfPlay.md +28 -0
- package/docs/sos/stream.md +78 -78
- package/docs/sos/sync.md +228 -21
- package/docs/sos/video.md +73 -73
- package/docs/sos_management/app.md +11 -11
- package/docs/sos_management/audio.md +3 -3
- package/docs/sos_management/firmware.md +11 -11
- package/docs/sos_management/index.md +9 -9
- package/docs/sos_management/network.md +10 -10
- package/docs/sos_management/package.md +6 -6
- package/docs/sos_management/power.md +27 -27
- package/docs/sos_management/screen.md +17 -17
- package/docs/sos_management/security.md +3 -3
- package/docs/sos_management/time.md +8 -8
- package/docs/sos_management/wifi.md +12 -12
- package/es6/FrontApplet/Debug/Debug.d.ts +1 -1
- package/es6/FrontApplet/Debug/Debug.js +1 -1
- package/es6/FrontApplet/DeviceInfo/DeviceInfo.d.ts +6 -2
- package/es6/FrontApplet/DeviceInfo/DeviceInfo.js +6 -2
- package/es6/FrontApplet/DeviceInfo/DeviceInfo.js.map +1 -1
- package/es6/FrontApplet/Display/Display.d.ts +1 -1
- package/es6/FrontApplet/Display/Display.js +1 -1
- package/es6/FrontApplet/Hardware/BarcodeScanner/BarcodeScanner.d.ts +36 -8
- package/es6/FrontApplet/Hardware/BarcodeScanner/BarcodeScanner.js +34 -2
- package/es6/FrontApplet/Hardware/BarcodeScanner/BarcodeScanner.js.map +1 -1
- package/es6/FrontApplet/Hardware/BarcodeScanner/IBarcodeScanner.d.ts +5 -0
- package/es6/FrontApplet/Hardware/Hardware.d.ts +34 -5
- package/es6/FrontApplet/Hardware/Hardware.js +33 -5
- package/es6/FrontApplet/Hardware/Hardware.js.map +1 -1
- package/es6/FrontApplet/Hardware/ISerialPort.d.ts +17 -1
- package/es6/FrontApplet/Hardware/ISerialPortDataMessage.d.ts +3 -0
- package/es6/FrontApplet/Hardware/ISerialPortOptions.d.ts +6 -0
- package/es6/FrontApplet/Hardware/ISerialPortOptions.js +3 -0
- package/es6/FrontApplet/Hardware/ISerialPortOptions.js.map +1 -1
- package/es6/FrontApplet/Hardware/Led/Led.d.ts +19 -3
- package/es6/FrontApplet/Hardware/Led/Led.js +19 -3
- package/es6/FrontApplet/Hardware/Led/Led.js.map +1 -1
- package/es6/FrontApplet/Monitors/Monitors.d.ts +5 -0
- package/es6/FrontApplet/Monitors/Monitors.js +5 -0
- package/es6/FrontApplet/Monitors/Monitors.js.map +1 -1
- package/es6/FrontApplet/NativeCommands/MDC/INativeMdcCommands.d.ts +1 -0
- package/es6/FrontApplet/OSD/OSD.d.ts +5 -1
- package/es6/FrontApplet/OSD/OSD.js +5 -1
- package/es6/FrontApplet/OSD/OSD.js.map +1 -1
- package/es6/FrontApplet/Offline/Cache/Cache.d.ts +205 -28
- package/es6/FrontApplet/Offline/Cache/Cache.js +205 -28
- package/es6/FrontApplet/Offline/Cache/Cache.js.map +1 -1
- package/es6/FrontApplet/Offline/IAddFont.js.map +1 -1
- package/es6/FrontApplet/Offline/IFileType.js.map +1 -1
- package/es6/FrontApplet/Offline/ISaveFile.d.ts +3 -0
- package/es6/FrontApplet/Offline/ISaveFile.js.map +1 -1
- package/es6/FrontApplet/Offline/Offline.d.ts +58 -15
- package/es6/FrontApplet/Offline/Offline.js +56 -13
- package/es6/FrontApplet/Offline/Offline.js.map +1 -1
- package/es6/FrontApplet/ProofOfPlay/IRecordItemOptions.d.ts +3 -0
- package/es6/FrontApplet/ProofOfPlay/ProofOfPlay.d.ts +15 -1
- package/es6/FrontApplet/ProofOfPlay/ProofOfPlay.js +15 -1
- package/es6/FrontApplet/ProofOfPlay/ProofOfPlay.js.map +1 -1
- package/es6/FrontApplet/Sync/Sync.d.ts +101 -18
- package/es6/FrontApplet/Sync/Sync.js +84 -10
- package/es6/FrontApplet/Sync/Sync.js.map +1 -1
- package/package.json +1 -1
package/docs/sos/sync.md
CHANGED
|
@@ -21,9 +21,42 @@ broadcastValue({ groupName, key, value }: {
|
|
|
21
21
|
}): Promise<void>;
|
|
22
22
|
```
|
|
23
23
|
|
|
24
|
+
#### Params
|
|
25
|
+
|
|
26
|
+
| Name | Type | Required | Description |
|
|
27
|
+
|-------------|----------|------------------|---------------------------------------------------------------------------------|
|
|
28
|
+
| `groupName` | `String` | <div>Yes</div> | The name of the group to broadcast the value to. Defaults to the default group. |
|
|
29
|
+
| `key` | `String` | <div>Yes</div> | The key to broadcast the value under. |
|
|
30
|
+
| `value` | `any` | <div>Yes</div> | The value to broadcast. It can be any valid type |
|
|
31
|
+
|
|
32
|
+
#### Return value
|
|
33
|
+
|
|
34
|
+
A promise that resolves when the value is broadcasted.
|
|
35
|
+
|
|
24
36
|
#### Possible errors
|
|
25
37
|
|
|
26
|
-
|
|
38
|
+
|
|
39
|
+
- Error If the group name is not a string.
|
|
40
|
+
- Error If the key is not a string.
|
|
41
|
+
- Error If the value is not a valid type (e.g. object, array, etc.).
|
|
42
|
+
- Error If unable to broadcast the value.
|
|
43
|
+
- Error If the value can't be sent
|
|
44
|
+
|
|
45
|
+
#### Example
|
|
46
|
+
|
|
47
|
+
```ts
|
|
48
|
+
// broadcast a value to all devices in the group
|
|
49
|
+
await sos.sync.broadcastValue({
|
|
50
|
+
groupName: 'my-group',
|
|
51
|
+
key: 'my-key',
|
|
52
|
+
value: 'my-value',
|
|
53
|
+
});
|
|
54
|
+
|
|
55
|
+
// Received on the other devices:
|
|
56
|
+
sos.sync.onValue((key, value, groupName) => {
|
|
57
|
+
console.log(`Received value for key ${key} in group ${groupName}:`, value);
|
|
58
|
+
});
|
|
59
|
+
```
|
|
27
60
|
|
|
28
61
|
<Separator />
|
|
29
62
|
|
|
@@ -31,20 +64,39 @@ if the value can't be sent
|
|
|
31
64
|
|
|
32
65
|
The `cancelWait()` method aborts a wait on all devices in a group. Sometimes it's necessary to cancel a pending wait. One such
|
|
33
66
|
situation would be when the group has to make a sudden change in content or another behavior but there's a risk that part of the group
|
|
34
|
-
already called wait() and is waiting for the rest but the rest will never call it at this point. In order to gracefully
|
|
67
|
+
already called wait() and is waiting for the rest but the rest will never call it at this point. In order to gracefully clean up any
|
|
35
68
|
pending activity, use this method.
|
|
36
69
|
|
|
70
|
+
:::warning
|
|
37
71
|
Any pending wait will be canceled and the promise will be rejected with an error.
|
|
72
|
+
:::
|
|
38
73
|
|
|
39
74
|
```ts expandable
|
|
40
75
|
cancelWait(groupName?: string): Promise<void>;
|
|
41
76
|
```
|
|
42
77
|
|
|
78
|
+
#### Params
|
|
79
|
+
|
|
80
|
+
| Name | Type | Required | Description |
|
|
81
|
+
|-------------|----------|-----------------|------------------------------------------------------------------------------|
|
|
82
|
+
| `groupName` | `string` | <div>No</div> | The name of the group to cancel the wait for. Defaults to the default group. |
|
|
83
|
+
|
|
84
|
+
#### Return value
|
|
85
|
+
|
|
86
|
+
A promise that resolves when the wait is canceled.
|
|
87
|
+
|
|
88
|
+
#### Possible errors
|
|
89
|
+
|
|
90
|
+
|
|
91
|
+
- Error If the group name is not a string.
|
|
92
|
+
- Error If unable to cancel the wait.
|
|
93
|
+
- Error If any other error occurs during canceling the wait.
|
|
94
|
+
|
|
43
95
|
#### Example
|
|
44
96
|
|
|
45
97
|
```ts
|
|
46
98
|
sos.sync.wait('someData', 'someRandomNameGroup').catch((err) => {
|
|
47
|
-
// this will
|
|
99
|
+
// this will happen once cancelWait is called
|
|
48
100
|
console.error('wait failed', err);
|
|
49
101
|
});
|
|
50
102
|
|
|
@@ -63,6 +115,14 @@ synchronization is not required any longer.
|
|
|
63
115
|
close(): Promise<void>;
|
|
64
116
|
```
|
|
65
117
|
|
|
118
|
+
#### Return value
|
|
119
|
+
|
|
120
|
+
A promise that resolves when the connection is closed.
|
|
121
|
+
|
|
122
|
+
#### Possible errors
|
|
123
|
+
|
|
124
|
+
Error If unable to close the connection.
|
|
125
|
+
|
|
66
126
|
<Separator />
|
|
67
127
|
|
|
68
128
|
### connect(options)
|
|
@@ -72,20 +132,27 @@ mandatory to call, since synchronization is an optional feature and doesn’t ge
|
|
|
72
132
|
You can optionally specify a custom sync server URI in case you are running the sync server in a custom location.
|
|
73
133
|
|
|
74
134
|
:::info
|
|
75
|
-
|
|
76
|
-
All devices, that should be synchronized together, must select the same engine. Otherwise they won't be able to communicate with each
|
|
135
|
+
All devices, that should be synchronized together, must select the same engine. Otherwise, they won't be able to communicate with each
|
|
77
136
|
other.
|
|
78
|
-
|
|
79
137
|
:::
|
|
80
138
|
|
|
81
139
|
```ts expandable
|
|
82
|
-
connect(options?:
|
|
140
|
+
connect(options?: SynchronizationEngineOptions): Promise<void>;
|
|
83
141
|
// show-more
|
|
142
|
+
type SynchronizationEngineOptions = ConnectSyncServerOptions | ConnectP2PLocalOptions | ConnectUdpOptions;
|
|
143
|
+
|
|
144
|
+
/**
|
|
145
|
+
* Options for sync-server synchronization.
|
|
146
|
+
*/
|
|
84
147
|
interface ConnectSyncServerOptions {
|
|
85
148
|
engine?: SyncEngine.SyncServer;
|
|
86
149
|
uri?: string;
|
|
87
150
|
}
|
|
88
151
|
|
|
152
|
+
/**
|
|
153
|
+
* The `SyncEngine` enum defines the available synchronization engines that can be used to synchronize devices.
|
|
154
|
+
* Each engine has its own method of connecting devices and synchronizing data.
|
|
155
|
+
*/
|
|
89
156
|
enum SyncEngine {
|
|
90
157
|
/** Use external sync server. Device will connect to the server via websocket. */
|
|
91
158
|
SyncServer = "sync-server",
|
|
@@ -98,6 +165,9 @@ enum SyncEngine {
|
|
|
98
165
|
Udp = "udp"
|
|
99
166
|
}
|
|
100
167
|
|
|
168
|
+
/**
|
|
169
|
+
* Options for P2P local synchronization.
|
|
170
|
+
*/
|
|
101
171
|
interface ConnectP2PLocalOptions {
|
|
102
172
|
engine: SyncEngine.P2PLocal;
|
|
103
173
|
}
|
|
@@ -111,14 +181,22 @@ interface ConnectUdpOptions {
|
|
|
111
181
|
|
|
112
182
|
#### Params
|
|
113
183
|
|
|
114
|
-
| Name
|
|
115
|
-
|
|
116
|
-
| `options.engine`
|
|
117
|
-
| `options.uri`
|
|
184
|
+
| Name | Type | Required | Description |
|
|
185
|
+
|------------------|--------------------------------|------------------|----------------------------------------------------------------------------------------------------------------|
|
|
186
|
+
| `options.engine` | `SynchronizationEngineOptions` | <div>Yes</div> | Synchronization engine to use. |
|
|
187
|
+
| `options.uri` | `string` | <div>No</div> | Address of the sync server engine. Only relevant for sync-server. If omitted, the default server will be used. |
|
|
188
|
+
|
|
189
|
+
#### Return value
|
|
190
|
+
|
|
191
|
+
A promise that resolves when the connection is established.
|
|
118
192
|
|
|
119
193
|
#### Possible errors
|
|
120
194
|
|
|
121
|
-
|
|
195
|
+
|
|
196
|
+
- Error If unable to connect.
|
|
197
|
+
- Error If the `uri` is not a valid URL when using the sync-server engine.
|
|
198
|
+
- Error If the `engine` is not a valid synchronization engine.
|
|
199
|
+
- Error If any other error occurs during connection.
|
|
122
200
|
|
|
123
201
|
#### Example
|
|
124
202
|
|
|
@@ -136,6 +214,13 @@ await sos.sync.connect({ engine: 'sync-server', uri: syncServerUri });
|
|
|
136
214
|
await sos.sync.connect({ engine: 'p2p-local' });
|
|
137
215
|
```
|
|
138
216
|
|
|
217
|
+
:::note[GitHub Example]
|
|
218
|
+
|
|
219
|
+
- [ How to use synchronizer in applet](https://github.com/signageos/applet-examples/tree/master/examples/content-js-api/sync-video)
|
|
220
|
+
- [ How to synchronize mixed content](https://github.com/signageos/applet-examples/tree/master/examples/content-js-api/sync-mixed-content)
|
|
221
|
+
|
|
222
|
+
:::
|
|
223
|
+
|
|
139
224
|
<Separator />
|
|
140
225
|
|
|
141
226
|
### isMaster()
|
|
@@ -148,9 +233,13 @@ isMaster(groupName?: string): Promise<boolean>;
|
|
|
148
233
|
|
|
149
234
|
#### Params
|
|
150
235
|
|
|
151
|
-
| Name
|
|
152
|
-
|
|
153
|
-
| `groupName`
|
|
236
|
+
| Name | Type | Required | Description |
|
|
237
|
+
|-------------|----------|-----------------|---------------------------------------------------------------------------|
|
|
238
|
+
| `groupName` | `string` | <div>No</div> | The group name to check for master status. Defaults to the default group. |
|
|
239
|
+
|
|
240
|
+
#### Return value
|
|
241
|
+
|
|
242
|
+
A promise that resolves with true if the device is the master, false otherwise.
|
|
154
243
|
|
|
155
244
|
<Separator />
|
|
156
245
|
|
|
@@ -168,11 +257,34 @@ joinGroup(options: {
|
|
|
168
257
|
|
|
169
258
|
#### Params
|
|
170
259
|
|
|
171
|
-
| Name
|
|
172
|
-
|
|
173
|
-
| `options
|
|
174
|
-
|
|
175
|
-
|
|
260
|
+
| Name | Type | Required | Description |
|
|
261
|
+
|-----------|------------------------------------------------------------------------------------|------------------|------------------------------|
|
|
262
|
+
| `options` | `{ groupName?: string \| undefined; deviceIdentification?: string \| undefined; }` | <div>Yes</div> | Options for joining a group. |
|
|
263
|
+
|
|
264
|
+
#### Return value
|
|
265
|
+
|
|
266
|
+
A promise that resolves when the device joins the group.
|
|
267
|
+
|
|
268
|
+
#### Possible errors
|
|
269
|
+
|
|
270
|
+
|
|
271
|
+
- Error If the group name is not a string.
|
|
272
|
+
- Error If the device identification is not a string.
|
|
273
|
+
- Error If unable to join the group.
|
|
274
|
+
- Error If any other error occurs during joining the group.
|
|
275
|
+
|
|
276
|
+
#### Example
|
|
277
|
+
|
|
278
|
+
```ts
|
|
279
|
+
await sos.sync.connect();
|
|
280
|
+
await sos.sync.joinGroup({ groupName: 'my-group', deviceIdentification: 'my-device-id' });
|
|
281
|
+
```
|
|
282
|
+
|
|
283
|
+
:::note[GitHub Example]
|
|
284
|
+
|
|
285
|
+
- [ How to use synchronizer in applet](https://github.com/signageos/applet-examples/tree/master/examples/content-js-api/sync-video)
|
|
286
|
+
|
|
287
|
+
:::
|
|
176
288
|
|
|
177
289
|
<Separator />
|
|
178
290
|
|
|
@@ -184,11 +296,34 @@ The `leaveMethod` method leaves a group of devices.
|
|
|
184
296
|
leaveGroup(groupName?: string): Promise<void>;
|
|
185
297
|
```
|
|
186
298
|
|
|
299
|
+
#### Params
|
|
300
|
+
|
|
301
|
+
| Name | Type | Required | Description |
|
|
302
|
+
|-------------|----------|-----------------|----------------------------------------------------------------|
|
|
303
|
+
| `groupName` | `string` | <div>No</div> | The name of the group to leave. Defaults to the default group. |
|
|
304
|
+
|
|
305
|
+
#### Return value
|
|
306
|
+
|
|
307
|
+
A promise that resolves when the device leaves the group.
|
|
308
|
+
|
|
309
|
+
#### Possible errors
|
|
310
|
+
|
|
311
|
+
|
|
312
|
+
- Error If the group name is not a string.
|
|
313
|
+
- Error If unable to leave the group.
|
|
314
|
+
- Error If any other error occurs during leaving the group.
|
|
315
|
+
|
|
316
|
+
#### Example
|
|
317
|
+
|
|
318
|
+
```ts
|
|
319
|
+
await sos.sync.leaveGroup('my-group');
|
|
320
|
+
```
|
|
321
|
+
|
|
187
322
|
<Separator />
|
|
188
323
|
|
|
189
324
|
### onClosed()
|
|
190
325
|
|
|
191
|
-
The `
|
|
326
|
+
The `onClosed()` method sets up a listener, which is called whenever the device is disconnected from the sync. If it closed because
|
|
192
327
|
`close()` was called, it will emit without any arguments. if it closed because of an error, it will emit with an error object as the
|
|
193
328
|
first argument.
|
|
194
329
|
|
|
@@ -196,6 +331,20 @@ first argument.
|
|
|
196
331
|
onClosed(listener: (error?: Error) => void): void;
|
|
197
332
|
```
|
|
198
333
|
|
|
334
|
+
#### Params
|
|
335
|
+
|
|
336
|
+
| Name | Type | Required | Description |
|
|
337
|
+
|------------|----------------------------------------|------------------|--------------------------------------------------------|
|
|
338
|
+
| `listener` | `(error?: Error \| undefined) => void` | <div>Yes</div> | The listener function to call when the sync is closed. |
|
|
339
|
+
|
|
340
|
+
#### Return value
|
|
341
|
+
|
|
342
|
+
Returns when listener is set up.
|
|
343
|
+
|
|
344
|
+
#### Possible errors
|
|
345
|
+
|
|
346
|
+
Error If the listener is not a function.
|
|
347
|
+
|
|
199
348
|
<Separator />
|
|
200
349
|
|
|
201
350
|
### onStatus()
|
|
@@ -216,6 +365,20 @@ interface StatusEvent {
|
|
|
216
365
|
|
|
217
366
|
```
|
|
218
367
|
|
|
368
|
+
#### Params
|
|
369
|
+
|
|
370
|
+
| Name | Type | Required | Description |
|
|
371
|
+
|------------|---------------------------------|------------------|--------------------------------------------------------|
|
|
372
|
+
| `listener` | `(status: StatusEvent) => void` | <div>Yes</div> | The listener function to call when the status changes. |
|
|
373
|
+
|
|
374
|
+
#### Return value
|
|
375
|
+
|
|
376
|
+
Returns when listener is set up.
|
|
377
|
+
|
|
378
|
+
#### Possible errors
|
|
379
|
+
|
|
380
|
+
Error If the listener is not a function.
|
|
381
|
+
|
|
219
382
|
<Separator />
|
|
220
383
|
|
|
221
384
|
### onValue()
|
|
@@ -226,6 +389,20 @@ The `onValue()` method sets up a listener, which is called whenever the device r
|
|
|
226
389
|
onValue(listener: (key: string, value: any, groupName?: string) => void): void;
|
|
227
390
|
```
|
|
228
391
|
|
|
392
|
+
#### Params
|
|
393
|
+
|
|
394
|
+
| Name | Type | Required | Description |
|
|
395
|
+
|------------|----------------------------------------------------------------------|------------------|------------------------------------------------------------|
|
|
396
|
+
| `listener` | `(key: string, value: any, groupName?: string \| undefined) => void` | <div>Yes</div> | The listener function to call when a value is broadcasted. |
|
|
397
|
+
|
|
398
|
+
#### Return value
|
|
399
|
+
|
|
400
|
+
Returns when listener is set up.
|
|
401
|
+
|
|
402
|
+
#### Possible errors
|
|
403
|
+
|
|
404
|
+
Error If the listener is not a function.
|
|
405
|
+
|
|
229
406
|
<Separator />
|
|
230
407
|
|
|
231
408
|
### removeEventListeners()
|
|
@@ -259,6 +436,36 @@ argument.
|
|
|
259
436
|
wait(data?: any, groupName?: string, timeout?: number): Promise<any>;
|
|
260
437
|
```
|
|
261
438
|
|
|
439
|
+
#### Params
|
|
440
|
+
|
|
441
|
+
| Name | Type | Required | Description |
|
|
442
|
+
|-------------|----------|-----------------|-------------------------------------------------------------------------------|
|
|
443
|
+
| `data` | `any` | <div>No</div> | Optional data to pass to the group. |
|
|
444
|
+
| `groupName` | `string` | <div>No</div> | The name of the group to wait for. Defaults to the default group. |
|
|
445
|
+
| `timeout` | `number` | <div>No</div> | Timeout in milliseconds. If not specified, the default timeout is 30 seconds. |
|
|
446
|
+
|
|
447
|
+
#### Return value
|
|
448
|
+
|
|
449
|
+
A promise that resolves with the data from the master device when all devices are ready to continue.
|
|
450
|
+
|
|
451
|
+
#### Possible errors
|
|
452
|
+
|
|
453
|
+
|
|
454
|
+
- Error If the group name is not a string.
|
|
455
|
+
- Error If the timeout is not a number.
|
|
456
|
+
- Error If unable to wait for the group.
|
|
457
|
+
- Error If any other error occurs during waiting for the group.
|
|
458
|
+
|
|
459
|
+
#### Example
|
|
460
|
+
|
|
461
|
+
```ts
|
|
462
|
+
// wait for all devices in the group to be ready
|
|
463
|
+
await sos.sync.wait('someData', 'someRandomNameGroup').then((data) => {
|
|
464
|
+
// this will be called once all devices are ready
|
|
465
|
+
console.log('All devices are ready with data:', data);
|
|
466
|
+
});
|
|
467
|
+
```
|
|
468
|
+
|
|
262
469
|
<Separator />
|
|
263
470
|
|
|
264
471
|
### ~connect(options)~
|
package/docs/sos/video.md
CHANGED
|
@@ -54,13 +54,13 @@ onceEnded(uri: string, x: number, y: number, width: number, height: number): Pro
|
|
|
54
54
|
|
|
55
55
|
#### Params
|
|
56
56
|
|
|
57
|
-
| Name | Type | Description |
|
|
58
|
-
|
|
59
|
-
| `uri` | `string` | Address to remote (online) or local video file |
|
|
60
|
-
| `x` | `number` | x-position for video on screen |
|
|
61
|
-
| `y` | `number` | y-position for video on screen |
|
|
62
|
-
| `width` | `number` | Video width on screen |
|
|
63
|
-
| `height` | `number` | Video height on screen |
|
|
57
|
+
| Name | Type | Required | Description |
|
|
58
|
+
|----------|----------|------------------|------------------------------------------------|
|
|
59
|
+
| `uri` | `string` | <div>Yes</div> | Address to remote (online) or local video file |
|
|
60
|
+
| `x` | `number` | <div>Yes</div> | x-position for video on screen |
|
|
61
|
+
| `y` | `number` | <div>Yes</div> | y-position for video on screen |
|
|
62
|
+
| `width` | `number` | <div>Yes</div> | Video width on screen |
|
|
63
|
+
| `height` | `number` | <div>Yes</div> | Video height on screen |
|
|
64
64
|
|
|
65
65
|
#### Return value
|
|
66
66
|
|
|
@@ -96,13 +96,13 @@ onceStop(uri: string, x: number, y: number, width: number, height: number): Prom
|
|
|
96
96
|
|
|
97
97
|
#### Params
|
|
98
98
|
|
|
99
|
-
| Name | Type | Description |
|
|
100
|
-
|
|
101
|
-
| `uri` | `string` | Address to remote (online) or local video file |
|
|
102
|
-
| `x` | `number` | x-position for video on screen |
|
|
103
|
-
| `y` | `number` | y-position for video on screen |
|
|
104
|
-
| `width` | `number` | Video width on screen |
|
|
105
|
-
| `height` | `number` | Video height on screen |
|
|
99
|
+
| Name | Type | Required | Description |
|
|
100
|
+
|----------|----------|------------------|------------------------------------------------|
|
|
101
|
+
| `uri` | `string` | <div>Yes</div> | Address to remote (online) or local video file |
|
|
102
|
+
| `x` | `number` | <div>Yes</div> | x-position for video on screen |
|
|
103
|
+
| `y` | `number` | <div>Yes</div> | y-position for video on screen |
|
|
104
|
+
| `width` | `number` | <div>Yes</div> | Video width on screen |
|
|
105
|
+
| `height` | `number` | <div>Yes</div> | Video height on screen |
|
|
106
106
|
|
|
107
107
|
#### Return value
|
|
108
108
|
|
|
@@ -169,9 +169,9 @@ interface IVideoProperties {
|
|
|
169
169
|
|
|
170
170
|
#### Params
|
|
171
171
|
|
|
172
|
-
| Name | Type | Description |
|
|
173
|
-
|
|
174
|
-
| `listener` | `(event: IVideoEvent) => void` | The listener function to be called when an ended event occurs. |
|
|
172
|
+
| Name | Type | Required | Description |
|
|
173
|
+
|------------|--------------------------------|------------------|----------------------------------------------------------------|
|
|
174
|
+
| `listener` | `(event: IVideoEvent) => void` | <div>Yes</div> | The listener function to be called when an ended event occurs. |
|
|
175
175
|
|
|
176
176
|
#### Return value
|
|
177
177
|
|
|
@@ -226,9 +226,9 @@ interface IVideoProperties {
|
|
|
226
226
|
|
|
227
227
|
#### Params
|
|
228
228
|
|
|
229
|
-
| Name | Type | Description |
|
|
230
|
-
|
|
231
|
-
| `listener` | `(event: IVideoEvent) => void` | The listener function to be called when an error occurs. |
|
|
229
|
+
| Name | Type | Required | Description |
|
|
230
|
+
|------------|--------------------------------|------------------|----------------------------------------------------------|
|
|
231
|
+
| `listener` | `(event: IVideoEvent) => void` | <div>Yes</div> | The listener function to be called when an error occurs. |
|
|
232
232
|
|
|
233
233
|
#### Return value
|
|
234
234
|
|
|
@@ -283,9 +283,9 @@ interface IVideoProperties {
|
|
|
283
283
|
|
|
284
284
|
#### Params
|
|
285
285
|
|
|
286
|
-
| Name | Type | Description |
|
|
287
|
-
|
|
288
|
-
| `listener` | `(event: IVideoEvent) => void` | The listener function to be called when a pause event occurs. |
|
|
286
|
+
| Name | Type | Required | Description |
|
|
287
|
+
|------------|--------------------------------|------------------|---------------------------------------------------------------|
|
|
288
|
+
| `listener` | `(event: IVideoEvent) => void` | <div>Yes</div> | The listener function to be called when a pause event occurs. |
|
|
289
289
|
|
|
290
290
|
#### Return value
|
|
291
291
|
|
|
@@ -340,9 +340,9 @@ interface IVideoProperties {
|
|
|
340
340
|
|
|
341
341
|
#### Params
|
|
342
342
|
|
|
343
|
-
| Name | Type | Description |
|
|
344
|
-
|
|
345
|
-
| `listener` | `(event: IVideoEvent) => void` | The listener function to be called when a play event occurs. |
|
|
343
|
+
| Name | Type | Required | Description |
|
|
344
|
+
|------------|--------------------------------|------------------|--------------------------------------------------------------|
|
|
345
|
+
| `listener` | `(event: IVideoEvent) => void` | <div>Yes</div> | The listener function to be called when a play event occurs. |
|
|
346
346
|
|
|
347
347
|
#### Return value
|
|
348
348
|
|
|
@@ -398,9 +398,9 @@ interface IVideoProperties {
|
|
|
398
398
|
|
|
399
399
|
#### Params
|
|
400
400
|
|
|
401
|
-
| Name | Type | Description |
|
|
402
|
-
|
|
403
|
-
| `listener` | `(event: IVideoEvent) => void` | The listener function to be called when a prepare event occurs. |
|
|
401
|
+
| Name | Type | Required | Description |
|
|
402
|
+
|------------|--------------------------------|------------------|-----------------------------------------------------------------|
|
|
403
|
+
| `listener` | `(event: IVideoEvent) => void` | <div>Yes</div> | The listener function to be called when a prepare event occurs. |
|
|
404
404
|
|
|
405
405
|
#### Return value
|
|
406
406
|
|
|
@@ -455,9 +455,9 @@ interface IVideoProperties {
|
|
|
455
455
|
|
|
456
456
|
#### Params
|
|
457
457
|
|
|
458
|
-
| Name | Type | Description |
|
|
459
|
-
|
|
460
|
-
| `listener` | `(event: IVideoEvent) => void` | The listener function to be called when a resume event occurs. |
|
|
458
|
+
| Name | Type | Required | Description |
|
|
459
|
+
|------------|--------------------------------|------------------|----------------------------------------------------------------|
|
|
460
|
+
| `listener` | `(event: IVideoEvent) => void` | <div>Yes</div> | The listener function to be called when a resume event occurs. |
|
|
461
461
|
|
|
462
462
|
#### Return value
|
|
463
463
|
|
|
@@ -514,9 +514,9 @@ interface IVideoProperties {
|
|
|
514
514
|
|
|
515
515
|
#### Params
|
|
516
516
|
|
|
517
|
-
| Name | Type | Description |
|
|
518
|
-
|
|
519
|
-
| `listener` | `(event: IVideoEvent) => void` | The listener function to be called when a stop event occurs. |
|
|
517
|
+
| Name | Type | Required | Description |
|
|
518
|
+
|------------|--------------------------------|------------------|--------------------------------------------------------------|
|
|
519
|
+
| `listener` | `(event: IVideoEvent) => void` | <div>Yes</div> | The listener function to be called when a stop event occurs. |
|
|
520
520
|
|
|
521
521
|
#### Return value
|
|
522
522
|
|
|
@@ -546,13 +546,13 @@ pause(uri: string, x: number, y: number, width: number, height: number): Promise
|
|
|
546
546
|
|
|
547
547
|
#### Params
|
|
548
548
|
|
|
549
|
-
| Name | Type | Description |
|
|
550
|
-
|
|
551
|
-
| `uri` | `string` | Address to remote (online) or local video file |
|
|
552
|
-
| `x` | `number` | x-position for video on screen |
|
|
553
|
-
| `y` | `number` | y-position for video on screen |
|
|
554
|
-
| `width` | `number` | Video width on screen |
|
|
555
|
-
| `height` | `number` | Video height on screen |
|
|
549
|
+
| Name | Type | Required | Description |
|
|
550
|
+
|----------|----------|------------------|------------------------------------------------|
|
|
551
|
+
| `uri` | `string` | <div>Yes</div> | Address to remote (online) or local video file |
|
|
552
|
+
| `x` | `number` | <div>Yes</div> | x-position for video on screen |
|
|
553
|
+
| `y` | `number` | <div>Yes</div> | y-position for video on screen |
|
|
554
|
+
| `width` | `number` | <div>Yes</div> | Video width on screen |
|
|
555
|
+
| `height` | `number` | <div>Yes</div> | Video height on screen |
|
|
556
556
|
|
|
557
557
|
#### Return value
|
|
558
558
|
|
|
@@ -590,13 +590,13 @@ play(uri: string, x: number, y: number, width: number, height: number): Promise<
|
|
|
590
590
|
|
|
591
591
|
#### Params
|
|
592
592
|
|
|
593
|
-
| Name | Type | Description |
|
|
594
|
-
|
|
595
|
-
| `uri` | `string` | Address to remote (online) or local video file |
|
|
596
|
-
| `x` | `number` | x-position for video on screen |
|
|
597
|
-
| `y` | `number` | y-position for video on screen |
|
|
598
|
-
| `width` | `number` | Video width on screen |
|
|
599
|
-
| `height` | `number` | Video height on screen |
|
|
593
|
+
| Name | Type | Required | Description |
|
|
594
|
+
|----------|----------|------------------|------------------------------------------------|
|
|
595
|
+
| `uri` | `string` | <div>Yes</div> | Address to remote (online) or local video file |
|
|
596
|
+
| `x` | `number` | <div>Yes</div> | x-position for video on screen |
|
|
597
|
+
| `y` | `number` | <div>Yes</div> | y-position for video on screen |
|
|
598
|
+
| `width` | `number` | <div>Yes</div> | Video width on screen |
|
|
599
|
+
| `height` | `number` | <div>Yes</div> | Video height on screen |
|
|
600
600
|
|
|
601
601
|
#### Return value
|
|
602
602
|
|
|
@@ -653,16 +653,16 @@ interface IOptions {
|
|
|
653
653
|
|
|
654
654
|
#### Params
|
|
655
655
|
|
|
656
|
-
| Name
|
|
657
|
-
|
|
658
|
-
| `uri`
|
|
659
|
-
| `x`
|
|
660
|
-
| `y`
|
|
661
|
-
| `width`
|
|
662
|
-
| `height`
|
|
663
|
-
| `options`
|
|
664
|
-
| `options.background`
|
|
665
|
-
| `options.volume`
|
|
656
|
+
| Name | Type | Required | Description |
|
|
657
|
+
|----------------------|------------|------------------|------------------------------------------------|
|
|
658
|
+
| `uri` | `string` | <div>Yes</div> | Address to remote (online) or local video file |
|
|
659
|
+
| `x` | `number` | <div>Yes</div> | x-position for video on screen |
|
|
660
|
+
| `y` | `number` | <div>Yes</div> | y-position for video on screen |
|
|
661
|
+
| `width` | `number` | <div>Yes</div> | Video width on screen |
|
|
662
|
+
| `height` | `number` | <div>Yes</div> | Video height on screen |
|
|
663
|
+
| `options` | `IOptions` | <div>No</div> | Optional options for preparing the video. |
|
|
664
|
+
| `options.background` | `boolean` | <div>No</div> | If view should be prepared in background. |
|
|
665
|
+
| `options.volume` | `number` | <div>No</div> | Initial volume value of the video. |
|
|
666
666
|
|
|
667
667
|
#### Return value
|
|
668
668
|
|
|
@@ -708,13 +708,13 @@ resume(uri: string, x: number, y: number, width: number, height: number): Promis
|
|
|
708
708
|
|
|
709
709
|
#### Params
|
|
710
710
|
|
|
711
|
-
| Name | Type | Description |
|
|
712
|
-
|
|
713
|
-
| `uri` | `string` | Address to remote (online) or local video file |
|
|
714
|
-
| `x` | `number` | x-position for video on screen |
|
|
715
|
-
| `y` | `number` | y-position for video on screen |
|
|
716
|
-
| `width` | `number` | Video width on screen |
|
|
717
|
-
| `height` | `number` | Video height on screen |
|
|
711
|
+
| Name | Type | Required | Description |
|
|
712
|
+
|----------|----------|------------------|------------------------------------------------|
|
|
713
|
+
| `uri` | `string` | <div>Yes</div> | Address to remote (online) or local video file |
|
|
714
|
+
| `x` | `number` | <div>Yes</div> | x-position for video on screen |
|
|
715
|
+
| `y` | `number` | <div>Yes</div> | y-position for video on screen |
|
|
716
|
+
| `width` | `number` | <div>Yes</div> | Video width on screen |
|
|
717
|
+
| `height` | `number` | <div>Yes</div> | Video height on screen |
|
|
718
718
|
|
|
719
719
|
#### Return value
|
|
720
720
|
|
|
@@ -754,13 +754,13 @@ stop(uri: string, x: number, y: number, width: number, height: number): Promise<
|
|
|
754
754
|
|
|
755
755
|
#### Params
|
|
756
756
|
|
|
757
|
-
| Name | Type | Description |
|
|
758
|
-
|
|
759
|
-
| `uri` | `string` | Address to remote (online) or local video file |
|
|
760
|
-
| `x` | `number` | x-position for video on screen |
|
|
761
|
-
| `y` | `number` | y-position for video on screen |
|
|
762
|
-
| `width` | `number` | Video width on screen |
|
|
763
|
-
| `height` | `number` | Video height on screen |
|
|
757
|
+
| Name | Type | Required | Description |
|
|
758
|
+
|----------|----------|------------------|------------------------------------------------|
|
|
759
|
+
| `uri` | `string` | <div>Yes</div> | Address to remote (online) or local video file |
|
|
760
|
+
| `x` | `number` | <div>Yes</div> | x-position for video on screen |
|
|
761
|
+
| `y` | `number` | <div>Yes</div> | y-position for video on screen |
|
|
762
|
+
| `width` | `number` | <div>Yes</div> | Video width on screen |
|
|
763
|
+
| `height` | `number` | <div>Yes</div> | Video height on screen |
|
|
764
764
|
|
|
765
765
|
#### Return value
|
|
766
766
|
|
|
@@ -65,9 +65,9 @@ upgrade(appUri: string): Promise<void>;
|
|
|
65
65
|
|
|
66
66
|
#### Params
|
|
67
67
|
|
|
68
|
-
| Name | Type | Description |
|
|
69
|
-
|
|
70
|
-
| `appUri` | `string` | FQN uri where the application main file is located. |
|
|
68
|
+
| Name | Type | Required | Description |
|
|
69
|
+
|----------|----------|------------------|-----------------------------------------------------|
|
|
70
|
+
| `appUri` | `string` | <div>Yes</div> | FQN uri where the application main file is located. |
|
|
71
71
|
|
|
72
72
|
<Separator />
|
|
73
73
|
|
|
@@ -81,10 +81,10 @@ upgrade(baseUrl: string, version: string): Promise<void>;
|
|
|
81
81
|
|
|
82
82
|
#### Params
|
|
83
83
|
|
|
84
|
-
| Name | Type | Description |
|
|
85
|
-
|
|
86
|
-
| `baseUrl` | `string` | The server URL where application files are located. |
|
|
87
|
-
| `version` | `string` | The version of the application being installed. |
|
|
84
|
+
| Name | Type | Required | Description |
|
|
85
|
+
|-----------|----------|------------------|-----------------------------------------------------|
|
|
86
|
+
| `baseUrl` | `string` | <div>Yes</div> | The server URL where application files are located. |
|
|
87
|
+
| `version` | `string` | <div>Yes</div> | The version of the application being installed. |
|
|
88
88
|
|
|
89
89
|
<Separator />
|
|
90
90
|
|
|
@@ -100,7 +100,7 @@ upgrade(version: string, baseUrl?: string): Promise<void>;
|
|
|
100
100
|
|
|
101
101
|
#### Params
|
|
102
102
|
|
|
103
|
-
| Name
|
|
104
|
-
|
|
105
|
-
| `version`
|
|
106
|
-
| `baseUrl`
|
|
103
|
+
| Name | Type | Required | Description |
|
|
104
|
+
|-----------|----------|------------------|----------------------------------------------------------------------------------------------------------|
|
|
105
|
+
| `version` | `string` | <div>Yes</div> | The version of the application being installed. |
|
|
106
|
+
| `baseUrl` | `string` | <div>No</div> | Optional server URL where application files are located.<br/>(Default value: `"https://2.signageos.io"`) |
|