@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.
Files changed (79) hide show
  1. package/dist/bundle.js.map +1 -1
  2. package/docs/sos/browser.md +17 -17
  3. package/docs/sos/command.md +6 -6
  4. package/docs/sos/debug.md +7 -3
  5. package/docs/sos/deviceInfo.md +6 -2
  6. package/docs/sos/display.md +3 -3
  7. package/docs/sos/fileSystem.md +67 -67
  8. package/docs/sos/hardware/barcodeScanner.md +58 -15
  9. package/docs/sos/hardware/index.md +72 -15
  10. package/docs/sos/hardware/led.md +32 -3
  11. package/docs/sos/index.md +3 -3
  12. package/docs/sos/input.md +7 -7
  13. package/docs/sos/monitors.md +8 -0
  14. package/docs/sos/native/mdc.md +9 -9
  15. package/docs/sos/offline/cache.md +368 -28
  16. package/docs/sos/offline/index.md +127 -24
  17. package/docs/sos/osd.md +8 -1
  18. package/docs/sos/proofOfPlay.md +28 -0
  19. package/docs/sos/stream.md +78 -78
  20. package/docs/sos/sync.md +228 -21
  21. package/docs/sos/video.md +73 -73
  22. package/docs/sos_management/app.md +11 -11
  23. package/docs/sos_management/audio.md +3 -3
  24. package/docs/sos_management/firmware.md +11 -11
  25. package/docs/sos_management/index.md +9 -9
  26. package/docs/sos_management/network.md +10 -10
  27. package/docs/sos_management/package.md +6 -6
  28. package/docs/sos_management/power.md +27 -27
  29. package/docs/sos_management/screen.md +17 -17
  30. package/docs/sos_management/security.md +3 -3
  31. package/docs/sos_management/time.md +8 -8
  32. package/docs/sos_management/wifi.md +12 -12
  33. package/es6/FrontApplet/Debug/Debug.d.ts +1 -1
  34. package/es6/FrontApplet/Debug/Debug.js +1 -1
  35. package/es6/FrontApplet/DeviceInfo/DeviceInfo.d.ts +6 -2
  36. package/es6/FrontApplet/DeviceInfo/DeviceInfo.js +6 -2
  37. package/es6/FrontApplet/DeviceInfo/DeviceInfo.js.map +1 -1
  38. package/es6/FrontApplet/Display/Display.d.ts +1 -1
  39. package/es6/FrontApplet/Display/Display.js +1 -1
  40. package/es6/FrontApplet/Hardware/BarcodeScanner/BarcodeScanner.d.ts +36 -8
  41. package/es6/FrontApplet/Hardware/BarcodeScanner/BarcodeScanner.js +34 -2
  42. package/es6/FrontApplet/Hardware/BarcodeScanner/BarcodeScanner.js.map +1 -1
  43. package/es6/FrontApplet/Hardware/BarcodeScanner/IBarcodeScanner.d.ts +5 -0
  44. package/es6/FrontApplet/Hardware/Hardware.d.ts +34 -5
  45. package/es6/FrontApplet/Hardware/Hardware.js +33 -5
  46. package/es6/FrontApplet/Hardware/Hardware.js.map +1 -1
  47. package/es6/FrontApplet/Hardware/ISerialPort.d.ts +17 -1
  48. package/es6/FrontApplet/Hardware/ISerialPortDataMessage.d.ts +3 -0
  49. package/es6/FrontApplet/Hardware/ISerialPortOptions.d.ts +6 -0
  50. package/es6/FrontApplet/Hardware/ISerialPortOptions.js +3 -0
  51. package/es6/FrontApplet/Hardware/ISerialPortOptions.js.map +1 -1
  52. package/es6/FrontApplet/Hardware/Led/Led.d.ts +19 -3
  53. package/es6/FrontApplet/Hardware/Led/Led.js +19 -3
  54. package/es6/FrontApplet/Hardware/Led/Led.js.map +1 -1
  55. package/es6/FrontApplet/Monitors/Monitors.d.ts +5 -0
  56. package/es6/FrontApplet/Monitors/Monitors.js +5 -0
  57. package/es6/FrontApplet/Monitors/Monitors.js.map +1 -1
  58. package/es6/FrontApplet/NativeCommands/MDC/INativeMdcCommands.d.ts +1 -0
  59. package/es6/FrontApplet/OSD/OSD.d.ts +5 -1
  60. package/es6/FrontApplet/OSD/OSD.js +5 -1
  61. package/es6/FrontApplet/OSD/OSD.js.map +1 -1
  62. package/es6/FrontApplet/Offline/Cache/Cache.d.ts +205 -28
  63. package/es6/FrontApplet/Offline/Cache/Cache.js +205 -28
  64. package/es6/FrontApplet/Offline/Cache/Cache.js.map +1 -1
  65. package/es6/FrontApplet/Offline/IAddFont.js.map +1 -1
  66. package/es6/FrontApplet/Offline/IFileType.js.map +1 -1
  67. package/es6/FrontApplet/Offline/ISaveFile.d.ts +3 -0
  68. package/es6/FrontApplet/Offline/ISaveFile.js.map +1 -1
  69. package/es6/FrontApplet/Offline/Offline.d.ts +58 -15
  70. package/es6/FrontApplet/Offline/Offline.js +56 -13
  71. package/es6/FrontApplet/Offline/Offline.js.map +1 -1
  72. package/es6/FrontApplet/ProofOfPlay/IRecordItemOptions.d.ts +3 -0
  73. package/es6/FrontApplet/ProofOfPlay/ProofOfPlay.d.ts +15 -1
  74. package/es6/FrontApplet/ProofOfPlay/ProofOfPlay.js +15 -1
  75. package/es6/FrontApplet/ProofOfPlay/ProofOfPlay.js.map +1 -1
  76. package/es6/FrontApplet/Sync/Sync.d.ts +101 -18
  77. package/es6/FrontApplet/Sync/Sync.js +84 -10
  78. package/es6/FrontApplet/Sync/Sync.js.map +1 -1
  79. package/package.json +1 -1
@@ -28,9 +28,9 @@ setVolume(volume: number): Promise<void>;
28
28
 
29
29
  #### Params
30
30
 
31
- | Name | Type | Description |
32
- |----------|----------|--------------------------|
33
- | `volume` | `number` | Value between 0 and 100. |
31
+ | Name | Type | Required | Description |
32
+ |----------|----------|------------------|--------------------------|
33
+ | `volume` | `number` | <div>Yes</div> | Value between 0 and 100. |
34
34
 
35
35
  ## API Example
36
36
 
@@ -54,10 +54,10 @@ upgrade(baseUrl: string, version: string): Promise<void>;
54
54
 
55
55
  #### Params
56
56
 
57
- | Name | Type | Description |
58
- |-----------|----------|--------------------------------------------------|
59
- | `baseUrl` | `string` | The server URL where firmware files are located. |
60
- | `version` | `string` | The version of the firmware being installed. |
57
+ | Name | Type | Required | Description |
58
+ |-----------|----------|------------------|--------------------------------------------------|
59
+ | `baseUrl` | `string` | <div>Yes</div> | The server URL where firmware files are located. |
60
+ | `version` | `string` | <div>Yes</div> | The version of the firmware being installed. |
61
61
 
62
62
  #### Example
63
63
 
@@ -86,9 +86,9 @@ upgrade(fwUri: string): Promise<void>;
86
86
 
87
87
  #### Params
88
88
 
89
- | Name | Type | Description |
90
- |---------|----------|--------------------------------------------------|
91
- | `fwUri` | `string` | FQN uri where the firmware main file is located. |
89
+ | Name | Type | Required | Description |
90
+ |---------|----------|------------------|--------------------------------------------------|
91
+ | `fwUri` | `string` | <div>Yes</div> | FQN uri where the firmware main file is located. |
92
92
 
93
93
  #### Example
94
94
 
@@ -110,7 +110,7 @@ upgrade(version: string, baseUrl?: string): Promise<void>;
110
110
 
111
111
  #### Params
112
112
 
113
- | Name | Type | Description |
114
- |------------------------|----------|-------------------------------------------------------------------------------------------------------|
115
- | `version` | `string` | The version of the firmware being installed. |
116
- | `baseUrl` *(optional)* | `string` | Optional server URL where firmware files are located.<br/>(Default value: `"https://2.signageos.io"`) |
113
+ | Name | Type | Required | Description |
114
+ |-----------|----------|------------------|-------------------------------------------------------------------------------------------------------|
115
+ | `version` | `string` | <div>Yes</div> | The version of the firmware being installed. |
116
+ | `baseUrl` | `string` | <div>No</div> | Optional server URL where firmware files are located.<br/>(Default value: `"https://2.signageos.io"`) |
@@ -136,9 +136,9 @@ setExtendedManagementUrl(url: string | null): Promise<void>;
136
136
 
137
137
  #### Params
138
138
 
139
- | Name | Type | Description |
140
- |-------|------------------|----------------------------|
141
- | `url` | `string \| null` | The management URL to set. |
139
+ | Name | Type | Required | Description |
140
+ |-------|------------------|------------------|----------------------------|
141
+ | `url` | `string \| null` | <div>Yes</div> | The management URL to set. |
142
142
 
143
143
  <Separator />
144
144
 
@@ -152,9 +152,9 @@ setHardwareAcceleration(enabled: boolean): Promise<void>;
152
152
 
153
153
  #### Params
154
154
 
155
- | Name | Type | Description |
156
- |-----------|-----------|--------------------------------------------------|
157
- | `enabled` | `boolean` | Whether hardware acceleration should be enabled. |
155
+ | Name | Type | Required | Description |
156
+ |-----------|-----------|------------------|--------------------------------------------------|
157
+ | `enabled` | `boolean` | <div>Yes</div> | Whether hardware acceleration should be enabled. |
158
158
 
159
159
  <Separator />
160
160
 
@@ -173,9 +173,9 @@ type AnyString = string & {};
173
173
 
174
174
  #### Params
175
175
 
176
- | Name | Type | Description |
177
- |--------------|------------------------|--------------------------------------|
178
- | `capability` | `ManagementCapability` | The capability to check for support. |
176
+ | Name | Type | Required | Description |
177
+ |--------------|------------------------|------------------|--------------------------------------|
178
+ | `capability` | `ManagementCapability` | <div>Yes</div> | The capability to check for support. |
179
179
 
180
180
  <Separator />
181
181
 
@@ -30,9 +30,9 @@ disableInterface(interfaceName: string): Promise<void>;
30
30
 
31
31
  #### Params
32
32
 
33
- | Name | Type | Description |
34
- |-----------------|----------|----------------------------------------------------------------------------------------------------|
35
- | `interfaceName` | `string` | The interface name which can be retrieved from the list of interfaces returned by listInterfaces() |
33
+ | Name | Type | Required | Description |
34
+ |-----------------|----------|------------------|----------------------------------------------------------------------------------------------------|
35
+ | `interfaceName` | `string` | <div>Yes</div> | The interface name which can be retrieved from the list of interfaces returned by listInterfaces() |
36
36
 
37
37
  <Separator />
38
38
 
@@ -85,9 +85,9 @@ setDHCP(interfaceName: string): Promise<void>;
85
85
 
86
86
  #### Params
87
87
 
88
- | Name | Type | Description |
89
- |-----------------|----------|----------------------------------------------------------------------------------------------------|
90
- | `interfaceName` | `string` | The interface name which can be retrieved from the list of interfaces returned by listInterfaces() |
88
+ | Name | Type | Required | Description |
89
+ |-----------------|----------|------------------|----------------------------------------------------------------------------------------------------|
90
+ | `interfaceName` | `string` | <div>Yes</div> | The interface name which can be retrieved from the list of interfaces returned by listInterfaces() |
91
91
 
92
92
  <Separator />
93
93
 
@@ -115,10 +115,10 @@ interface INetworkOptions {
115
115
 
116
116
  #### Params
117
117
 
118
- | Name | Type | Description |
119
- |-----------------|-------------------|----------------------------------------------------------------------------------------------------|
120
- | `interfaceName` | `string` | The interface name which can be retrieved from the list of interfaces returned by listInterfaces() |
121
- | `options` | `INetworkOptions` | The network configuration options. |
118
+ | Name | Type | Required | Description |
119
+ |-----------------|-------------------|------------------|----------------------------------------------------------------------------------------------------|
120
+ | `interfaceName` | `string` | <div>Yes</div> | The interface name which can be retrieved from the list of interfaces returned by listInterfaces() |
121
+ | `options` | `INetworkOptions` | <div>Yes</div> | The network configuration options. |
122
122
 
123
123
  <Separator />
124
124
 
@@ -18,12 +18,12 @@ install(baseUrl: string, packageName: string, version: string, build: string | n
18
18
 
19
19
  #### Params
20
20
 
21
- | Name | Type | Description |
22
- |---------------|------------------|------------------------------------|
23
- | `baseUrl` | `string` | URL where the package is available |
24
- | `packageName` | `string` | Name of the android package |
25
- | `version` | `string` | Package version |
26
- | `build` | `string \| null` | If relevant for your device |
21
+ | Name | Type | Required | Description |
22
+ |---------------|------------------|------------------|------------------------------------|
23
+ | `baseUrl` | `string` | <div>Yes</div> | URL where the package is available |
24
+ | `packageName` | `string` | <div>Yes</div> | Name of the android package |
25
+ | `version` | `string` | <div>Yes</div> | Package version |
26
+ | `build` | `string \| null` | <div>Yes</div> | If relevant for your device |
27
27
 
28
28
  ## API Example
29
29
 
@@ -128,9 +128,9 @@ removeScheduledReboot(id: string): Promise<void>;
128
128
 
129
129
  #### Params
130
130
 
131
- | Name | Type | Description |
132
- |------|----------|---------------------------------|
133
- | `id` | `string` | - ID of the rule to be removed. |
131
+ | Name | Type | Required | Description |
132
+ |------|----------|------------------|---------------------------------|
133
+ | `id` | `string` | <div>Yes</div> | - ID of the rule to be removed. |
134
134
 
135
135
  #### Example
136
136
 
@@ -155,13 +155,13 @@ setProprietaryTimer(type: ProprietaryTimerType, timeOn: string | null, timeOff:
155
155
 
156
156
  #### Params
157
157
 
158
- | Name | Type | Description |
159
- |----------------------------------|---------------------|-----------------------------------------------------------------------------------------|
160
- | `type` | ``TIMER_${number}`` | The type of the timer (`TIMER_1`, ..., `TIMER_7`). |
161
- | `timeOn` | `string \| null` | The time when the device should turn on. |
162
- | `timeOff` | `string \| null` | The time when the device should turn off. |
163
- | `weekdays` | `string[]` | The days of the week when the timer should be active (`mon`, ..., `sun`). |
164
- | `keepAppletRunning` *(optional)* | `boolean` | If `true`, the applet will be kept running when the timer is active on certain devices. |
158
+ | Name | Type | Required | Description |
159
+ |---------------------|---------------------|------------------|-----------------------------------------------------------------------------------------|
160
+ | `type` | ``TIMER_${number}`` | <div>Yes</div> | The type of the timer (`TIMER_1`, ..., `TIMER_7`). |
161
+ | `timeOn` | `string \| null` | <div>Yes</div> | The time when the device should turn on. |
162
+ | `timeOff` | `string \| null` | <div>Yes</div> | The time when the device should turn off. |
163
+ | `weekdays` | `string[]` | <div>Yes</div> | The days of the week when the timer should be active (`mon`, ..., `sun`). |
164
+ | `keepAppletRunning` | `boolean` | <div>No</div> | If `true`, the applet will be kept running when the timer is active on certain devices. |
165
165
 
166
166
  #### Example
167
167
 
@@ -190,10 +190,10 @@ type WeekdayType = 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' |
190
190
 
191
191
  #### Params
192
192
 
193
- | Name | Type | Description |
194
- |------------|-----------------|------------------------------------------------------------------|
195
- | `weekdays` | `WeekdayType[]` | |
196
- | `time` | `string` | - Time when the reboot should be executed. Format is `HH:mm:ss`. |
193
+ | Name | Type | Required | Description |
194
+ |------------|-----------------|------------------|------------------------------------------------------------------|
195
+ | `weekdays` | `WeekdayType[]` | <div>Yes</div> | |
196
+ | `time` | `string` | <div>Yes</div> | - Time when the reboot should be executed. Format is `HH:mm:ss`. |
197
197
 
198
198
  #### Example
199
199
 
@@ -217,13 +217,13 @@ setTimer(type: keyof typeof TimerType, timeOn: string | null, timeOff: string |
217
217
 
218
218
  #### Params
219
219
 
220
- | Name | Type | Description |
221
- |------------|-------------------------------------------------------------------------------------------|---------------------------------------------------------------------------|
222
- | `type` | `"TIMER_1" \| "TIMER_2" \| "TIMER_3" \| "TIMER_4" \| "TIMER_5" \| "TIMER_6" \| "TIMER_7"` | The type of the timer (`TIMER_1`, ..., `TIMER_7`). |
223
- | `timeOn` | `string \| null` | The time when the device should turn on. |
224
- | `timeOff` | `string \| null` | The time when the device should turn off. |
225
- | `weekdays` | `string[]` | The days of the week when the timer should be active (`mon`, ..., `sun`). |
226
- | `volume` | `number` | The volume level set when the device is turned on. |
220
+ | Name | Type | Required | Description |
221
+ |------------|-------------------------------------------------------------------------------------------|------------------|---------------------------------------------------------------------------|
222
+ | `type` | `"TIMER_1" \| "TIMER_2" \| "TIMER_3" \| "TIMER_4" \| "TIMER_5" \| "TIMER_6" \| "TIMER_7"` | <div>Yes</div> | The type of the timer (`TIMER_1`, ..., `TIMER_7`). |
223
+ | `timeOn` | `string \| null` | <div>Yes</div> | The time when the device should turn on. |
224
+ | `timeOff` | `string \| null` | <div>Yes</div> | The time when the device should turn off. |
225
+ | `weekdays` | `string[]` | <div>Yes</div> | The days of the week when the timer should be active (`mon`, ..., `sun`). |
226
+ | `volume` | `number` | <div>Yes</div> | The volume level set when the device is turned on. |
227
227
 
228
228
  #### Example
229
229
 
@@ -260,9 +260,9 @@ unsetProprietaryTimer(type: ProprietaryTimerType): Promise<void>;
260
260
 
261
261
  #### Params
262
262
 
263
- | Name | Type | Description |
264
- |--------|---------------------|----------------------------------------------------|
265
- | `type` | ``TIMER_${number}`` | The type of the timer (`TIMER_1`, ..., `TIMER_7`). |
263
+ | Name | Type | Required | Description |
264
+ |--------|---------------------|------------------|----------------------------------------------------|
265
+ | `type` | ``TIMER_${number}`` | <div>Yes</div> | The type of the timer (`TIMER_1`, ..., `TIMER_7`). |
266
266
 
267
267
  #### Example
268
268
 
@@ -282,9 +282,9 @@ unsetTimer(type: keyof typeof TimerType): Promise<void>;
282
282
 
283
283
  #### Params
284
284
 
285
- | Name | Type | Description |
286
- |--------|-------------------------------------------------------------------------------------------|----------------------------------------------------|
287
- | `type` | `"TIMER_1" \| "TIMER_2" \| "TIMER_3" \| "TIMER_4" \| "TIMER_5" \| "TIMER_6" \| "TIMER_7"` | The type of the timer (`TIMER_1`, ..., `TIMER_7`). |
285
+ | Name | Type | Required | Description |
286
+ |--------|-------------------------------------------------------------------------------------------|------------------|----------------------------------------------------|
287
+ | `type` | `"TIMER_1" \| "TIMER_2" \| "TIMER_3" \| "TIMER_4" \| "TIMER_5" \| "TIMER_6" \| "TIMER_7"` | <div>Yes</div> | The type of the timer (`TIMER_1`, ..., `TIMER_7`). |
288
288
 
289
289
  #### Example
290
290
 
@@ -117,13 +117,13 @@ resize(baseUrl: string, orientation: string, resolution: string, currentVersion:
117
117
 
118
118
  #### Params
119
119
 
120
- | Name | Type | Description |
121
- |---------------------------------|----------|--------------------------------------------------------------------------------------------------------------------------------------|
122
- | `baseUrl` | `string` | SSSP & Tizen devices requires to install a orientation-specific Core App if you want to switch orientation to portrait or landscape. |
123
- | `orientation` | `string` | Screen orientation |
124
- | `resolution` | `string` | Where it applies (mainly SSSP 2/3) |
125
- | `currentVersion` | `string` | Core App version |
126
- | `videoOrientation` *(optional)* | `string` | If the video has different orientation than the HTML5 content |
120
+ | Name | Type | Required | Description |
121
+ |--------------------|----------|------------------|--------------------------------------------------------------------------------------------------------------------------------------|
122
+ | `baseUrl` | `string` | <div>Yes</div> | SSSP & Tizen devices requires to install a orientation-specific Core App if you want to switch orientation to portrait or landscape. |
123
+ | `orientation` | `string` | <div>Yes</div> | Screen orientation |
124
+ | `resolution` | `string` | <div>Yes</div> | Where it applies (mainly SSSP 2/3) |
125
+ | `currentVersion` | `string` | <div>Yes</div> | Core App version |
126
+ | `videoOrientation` | `string` | <div>No</div> | If the video has different orientation than the HTML5 content |
127
127
 
128
128
  #### Example
129
129
 
@@ -163,12 +163,12 @@ setBrightness(timeFrom1: string, brightness1: number, timeFrom2: string, brightn
163
163
 
164
164
  #### Params
165
165
 
166
- | Name | Type | Description |
167
- |---------------|----------|------------------------------------|
168
- | `timeFrom1` | `string` | Time in the XX:XX format |
169
- | `brightness1` | `number` | Brightness value between 0 and 100 |
170
- | `timeFrom2` | `string` | Time in the XX:XX format |
171
- | `brightness2` | `number` | Brightness value between 0 and 100 |
166
+ | Name | Type | Required | Description |
167
+ |---------------|----------|------------------|------------------------------------|
168
+ | `timeFrom1` | `string` | <div>Yes</div> | Time in the XX:XX format |
169
+ | `brightness1` | `number` | <div>Yes</div> | Brightness value between 0 and 100 |
170
+ | `timeFrom2` | `string` | <div>Yes</div> | Time in the XX:XX format |
171
+ | `brightness2` | `number` | <div>Yes</div> | Brightness value between 0 and 100 |
172
172
 
173
173
  #### Example
174
174
 
@@ -206,10 +206,10 @@ takeAndUploadScreenshot(uploadBaseUrl: string, computeHash?: boolean): Promise<{
206
206
 
207
207
  #### Params
208
208
 
209
- | Name | Type | Description |
210
- |----------------------------|-----------|---------------------------------------------------------------------------------------------------------------|
211
- | `uploadBaseUrl` | `string` | URL to which the screenshot will be uploaded. It can be either a signageOS upload url or a custom server url. |
212
- | `computeHash` *(optional)* | `boolean` | Whether to compute a hash of the screenshot and return it in the response. |
209
+ | Name | Type | Required | Description |
210
+ |-----------------|-----------|------------------|---------------------------------------------------------------------------------------------------------------|
211
+ | `uploadBaseUrl` | `string` | <div>Yes</div> | URL to which the screenshot will be uploaded. It can be either a signageOS upload url or a custom server url. |
212
+ | `computeHash` | `boolean` | <div>No</div> | Whether to compute a hash of the screenshot and return it in the response. |
213
213
 
214
214
  #### Example
215
215
 
@@ -42,9 +42,9 @@ setPinCode(pinCode: string): Promise<void>;
42
42
 
43
43
  #### Params
44
44
 
45
- | Name | Type | Description |
46
- |-----------|----------|-------------------------|
47
- | `pinCode` | `string` | The PIN code to be set. |
45
+ | Name | Type | Required | Description |
46
+ |-----------|----------|------------------|-------------------------|
47
+ | `pinCode` | `string` | <div>Yes</div> | The PIN code to be set. |
48
48
 
49
49
  #### Possible errors
50
50
 
@@ -57,10 +57,10 @@ interface DateTime {
57
57
 
58
58
  #### Params
59
59
 
60
- | Name | Type | Description |
61
- |------------|------------|---------------------------|
62
- | `dateTime` | `DateTime` | The date and time to set. |
63
- | `timezone` | `string` | The timezone to set. |
60
+ | Name | Type | Required | Description |
61
+ |------------|------------|------------------|---------------------------|
62
+ | `dateTime` | `DateTime` | <div>Yes</div> | The date and time to set. |
63
+ | `timezone` | `string` | <div>Yes</div> | The timezone to set. |
64
64
 
65
65
  <Separator />
66
66
 
@@ -83,10 +83,10 @@ setNTP(ntpServer: string, timezone: string): Promise<void>;
83
83
 
84
84
  #### Params
85
85
 
86
- | Name | Type | Description |
87
- |-------------|----------|------------------------|
88
- | `ntpServer` | `string` | The NTP server to set. |
89
- | `timezone` | `string` | The timezone to set. |
86
+ | Name | Type | Required | Description |
87
+ |-------------|----------|------------------|------------------------|
88
+ | `ntpServer` | `string` | <div>Yes</div> | The NTP server to set. |
89
+ | `timezone` | `string` | <div>Yes</div> | The timezone to set. |
90
90
 
91
91
  <Separator />
92
92
 
@@ -54,11 +54,11 @@ type WifiEncryptionType = 'OPEN' | 'WEP' | 'WPA2' | 'WPA2_WPA_MIXED' | 'WPA3' |
54
54
 
55
55
  #### Params
56
56
 
57
- | Name | Type | Description |
58
- |-------------------------|-----------------------|----------------------------------------------------------------------------|
59
- | `ssid` | `string` | Name of the network, max. allowed length is 32 characters. |
60
- | `password` *(optional)* | `string` | Password of the device, must be between 8 and 32 characters. |
61
- | `options` *(optional)* | `IWifiConnectOptions` | Additional options for the connection, such as `hidden` or `securityType`. |
57
+ | Name | Type | Required | Description |
58
+ |------------|-----------------------|------------------|----------------------------------------------------------------------------|
59
+ | `ssid` | `string` | <div>Yes</div> | Name of the network, max. allowed length is 32 characters. |
60
+ | `password` | `string` | <div>No</div> | Password of the device, must be between 8 and 32 characters. |
61
+ | `options` | `IWifiConnectOptions` | <div>No</div> | Additional options for the connection, such as `hidden` or `securityType`. |
62
62
 
63
63
  #### Return value
64
64
 
@@ -126,10 +126,10 @@ enableAP(ssid: string, password: string): Promise<void>;
126
126
 
127
127
  #### Params
128
128
 
129
- | Name | Type | Description |
130
- |------------|----------|--------------------------------------------------------------|
131
- | `ssid` | `string` | Name of the network, max. allowed length is 32 characters. |
132
- | `password` | `string` | Password of the device, must be between 8 and 32 characters. |
129
+ | Name | Type | Required | Description |
130
+ |------------|----------|------------------|--------------------------------------------------------------|
131
+ | `ssid` | `string` | <div>Yes</div> | Name of the network, max. allowed length is 32 characters. |
132
+ | `password` | `string` | <div>Yes</div> | Password of the device, must be between 8 and 32 characters. |
133
133
 
134
134
  #### Possible errors
135
135
 
@@ -425,9 +425,9 @@ setCountry(countryCode: string): Promise<void>;
425
425
 
426
426
  #### Params
427
427
 
428
- | Name | Type | Description |
429
- |---------------|----------|---------------------------------------------------|
430
- | `countryCode` | `string` | 2-letter country code from the ISO 3166 standard. |
428
+ | Name | Type | Required | Description |
429
+ |---------------|----------|------------------|---------------------------------------------------|
430
+ | `countryCode` | `string` | <div>Yes</div> | 2-letter country code from the ISO 3166 standard. |
431
431
 
432
432
  #### Possible errors
433
433
 
@@ -20,7 +20,7 @@ export default class Debug extends EventEmitter implements IDebug {
20
20
  /**
21
21
  * The `isRemoteDebugEnabled()` method returns the state of the Device debug mode.
22
22
  *
23
- * @returens {Promise<boolean>} Resolves to `true` if the remote debug mode is enabled, otherwise `false`.
23
+ * @returns {Promise<boolean>} Resolves to `true` if the remote debug mode is enabled, otherwise `false`.
24
24
  * @since 5.8.0
25
25
  */
26
26
  isRemoteDebugEnabled(): Promise<boolean>;
@@ -29,7 +29,7 @@ class Debug extends events_1.EventEmitter {
29
29
  /**
30
30
  * The `isRemoteDebugEnabled()` method returns the state of the Device debug mode.
31
31
  *
32
- * @returens {Promise<boolean>} Resolves to `true` if the remote debug mode is enabled, otherwise `false`.
32
+ * @returns {Promise<boolean>} Resolves to `true` if the remote debug mode is enabled, otherwise `false`.
33
33
  * @since 5.8.0
34
34
  */
35
35
  async isRemoteDebugEnabled() {
@@ -15,7 +15,7 @@ export default class DeviceInfo implements IDeviceInfo {
15
15
  * updated when changed and persisted in local storage.
16
16
  *
17
17
  * :::note
18
- * Location can be set only in CloudControl on Device Info page, or via Rest API.
18
+ * Location can be set only in CloudControl on Device Info page, or via [Rest API](https://developers.signageos.io/api/#tag/DeviceLocation/paths/~1v1~1device~1%7BdeviceUid%7D~1location~1%7BlocationUid%7D/get).
19
19
  * :::
20
20
  *
21
21
  * @returns {Promise<IDeviceLocation | null>} A promise that resolves to the device location or `null` if not set.
@@ -27,7 +27,7 @@ export default class DeviceInfo implements IDeviceInfo {
27
27
  * updated when changed and persisted in local storage.
28
28
  *
29
29
  * :::note
30
- * Tags can be set only in CloudControl on Device Info page, or via Rest API.
30
+ * Tags can be set only in CloudControl on Device Info page, or via [Rest API](https://developers.signageos.io/api/#tag/DeviceTag-(Device-Tags)).
31
31
  * :::
32
32
  *
33
33
  * @returns {Promise<IOrganizationTag[]>} A promise that resolves to an array of organization tags.
@@ -38,6 +38,10 @@ export default class DeviceInfo implements IDeviceInfo {
38
38
  * The `getDeviceName()` method returns a name of the device. Name is requested from server on application start, automatically
39
39
  * updated when changed and persisted in local storage.
40
40
  *
41
+ * :::note
42
+ * Device name can be set only in CloudControl on Device Info page, or via [Rest API](https://developers.signageos.io/api/#tag/Device/paths/~1v2~1device~1%7BdeviceUid%7D/get).
43
+ * :::
44
+ *
41
45
  * @returns {Promise<string>} A promise that resolves to the device name.
42
46
  * @since 6.6.0
43
47
  *
@@ -18,7 +18,7 @@ class DeviceInfo {
18
18
  * updated when changed and persisted in local storage.
19
19
  *
20
20
  * :::note
21
- * Location can be set only in CloudControl on Device Info page, or via Rest API.
21
+ * Location can be set only in CloudControl on Device Info page, or via [Rest API](https://developers.signageos.io/api/#tag/DeviceLocation/paths/~1v1~1device~1%7BdeviceUid%7D~1location~1%7BlocationUid%7D/get).
22
22
  * :::
23
23
  *
24
24
  * @returns {Promise<IDeviceLocation | null>} A promise that resolves to the device location or `null` if not set.
@@ -33,7 +33,7 @@ class DeviceInfo {
33
33
  * updated when changed and persisted in local storage.
34
34
  *
35
35
  * :::note
36
- * Tags can be set only in CloudControl on Device Info page, or via Rest API.
36
+ * Tags can be set only in CloudControl on Device Info page, or via [Rest API](https://developers.signageos.io/api/#tag/DeviceTag-(Device-Tags)).
37
37
  * :::
38
38
  *
39
39
  * @returns {Promise<IOrganizationTag[]>} A promise that resolves to an array of organization tags.
@@ -47,6 +47,10 @@ class DeviceInfo {
47
47
  * The `getDeviceName()` method returns a name of the device. Name is requested from server on application start, automatically
48
48
  * updated when changed and persisted in local storage.
49
49
  *
50
+ * :::note
51
+ * Device name can be set only in CloudControl on Device Info page, or via [Rest API](https://developers.signageos.io/api/#tag/Device/paths/~1v2~1device~1%7BdeviceUid%7D/get).
52
+ * :::
53
+ *
50
54
  * @returns {Promise<string>} A promise that resolves to the device name.
51
55
  * @since 6.6.0
52
56
  *
@@ -1 +1 @@
1
- {"version":3,"file":"DeviceInfo.js","sourceRoot":"","sources":["../../../src/FrontApplet/DeviceInfo/DeviceInfo.ts"],"names":[],"mappings":";;AAGA;;;GAGG;AACH,MAAqB,UAAU;IAKrB;IACA;IALF,MAAM,CAAC,cAAc,GAAW,aAAa,CAAC;IAErD,gBAAgB;IAChB,YACS,aAAqB,EACrB,WAA8B;QAD9B,kBAAa,GAAb,aAAa,CAAQ;QACrB,gBAAW,GAAX,WAAW,CAAmB;IACpC,CAAC;IAEJ;;;;;;;;;;OAUG;IACI,KAAK,CAAC,WAAW;QACvB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QACvF,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED;;;;;;;;;;OAUG;IACI,KAAK,CAAC,mBAAmB;QAC/B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC,EAAE,CAAC,CAAC;QAC5F,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;;;;;;OAUG;IACI,KAAK,CAAC,aAAa;QACzB,OAAO,IAAI,CAAC,sBAAsB,EAAE,CAAC;IACtC,CAAC;IAEO,UAAU,CAAC,IAAY;QAC9B,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxE,CAAC;IAEO,sBAAsB;QAC7B,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC5C,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACxE,MAAM,aAAa,GAAG,YAAY,CAAC,aAAc,CAAC;QAClD,OAAO,aAAa,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC;IACvE,CAAC;;AAjEF,6BAkEC"}
1
+ {"version":3,"file":"DeviceInfo.js","sourceRoot":"","sources":["../../../src/FrontApplet/DeviceInfo/DeviceInfo.ts"],"names":[],"mappings":";;AAGA;;;GAGG;AACH,MAAqB,UAAU;IAKrB;IACA;IALF,MAAM,CAAC,cAAc,GAAW,aAAa,CAAC;IAErD,gBAAgB;IAChB,YACS,aAAqB,EACrB,WAA8B;QAD9B,kBAAa,GAAb,aAAa,CAAQ;QACrB,gBAAW,GAAX,WAAW,CAAmB;IACpC,CAAC;IAEJ;;;;;;;;;;OAUG;IACI,KAAK,CAAC,WAAW;QACvB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QACvF,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED;;;;;;;;;;OAUG;IACI,KAAK,CAAC,mBAAmB;QAC/B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC,EAAE,CAAC,CAAC;QAC5F,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACI,KAAK,CAAC,aAAa;QACzB,OAAO,IAAI,CAAC,sBAAsB,EAAE,CAAC;IACtC,CAAC;IAEO,UAAU,CAAC,IAAY;QAC9B,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxE,CAAC;IAEO,sBAAsB;QAC7B,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC5C,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACxE,MAAM,aAAa,GAAG,YAAY,CAAC,aAAc,CAAC;QAClD,OAAO,aAAa,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC;IACvE,CAAC;;AArEF,6BAsEC"}
@@ -32,7 +32,7 @@ declare class Display implements IDisplay {
32
32
  constructor(messagePrefix: string, postMessage: IPostMessage<any>);
33
33
  /**
34
34
  * The `supports()` method determines whether a queried capability is supported by the device.
35
- * @param capability - The capability to check for support.
35
+ * @param capability The capability to check for support.
36
36
  * @returns {Promise<boolean>} Resolves to `true` if the capability is supported, otherwise `false`.
37
37
  * @since 3.1.0
38
38
  */
@@ -39,7 +39,7 @@ class Display {
39
39
  }
40
40
  /**
41
41
  * The `supports()` method determines whether a queried capability is supported by the device.
42
- * @param capability - The capability to check for support.
42
+ * @param capability The capability to check for support.
43
43
  * @returns {Promise<boolean>} Resolves to `true` if the capability is supported, otherwise `false`.
44
44
  * @since 3.1.0
45
45
  */
@@ -1,7 +1,15 @@
1
1
  import IPostMessage from '../../IPostMessage';
2
2
  import IBarcodeScannerDataMessage from './IBarcodeScannerDataMessage';
3
- import IBarcodeScanner, { IBarcodeScannerOptions } from './IBarcodeScanner';
3
+ import IBarcodeScanner, { IBarcodeScannerOptions, IBarcodeScannerResponse } from './IBarcodeScanner';
4
4
  export declare const DEFAULT_SCANNER_ID = 0;
5
+ /**
6
+ * The `sos.hardware.barcodeScanner` API provides methods for working with barcode scanners.
7
+ * It allows starting and stopping the scanner, as well as listening for scanned data and errors.
8
+ *
9
+ * :::note
10
+ * This API is experimental and may change in the future.
11
+ * :::
12
+ */
5
13
  export default class BarcodeScanner implements IBarcodeScanner {
6
14
  private messagePrefix;
7
15
  private postMessage;
@@ -10,17 +18,37 @@ export default class BarcodeScanner implements IBarcodeScanner {
10
18
  /** @internal */
11
19
  constructor(messagePrefix: string, postMessage: IPostMessage<any>);
12
20
  /**
13
- * @experimental
21
+ * The `getVersion()` method returns the version of the barcode scanner.
22
+ *
23
+ * @returns {Promise<string>} Returns a promise that resolves to the version of the barcode scanner.
24
+ * @throws {Error} If the version cannot be retrieved.
25
+ * @since 3.0.0
14
26
  */
15
27
  getVersion(): Promise<string>;
16
28
  /**
17
- * @experimental
29
+ * The `start()` starts the barcode scanner and starts listening for scanned data.
30
+ * @param userOptions User options to configure the scanner.
31
+ * @param userOptions.timeout The maximum time to wait for a scan before timing out.
32
+ * @param userOptions.cancelPrevious If set to `true`, it will cancel any previous scanner instance with the same `scannerId`.
33
+ * @returns Returns a promise that resolves to an object with methods to stop the scanner and listen for scanned data and errors.
34
+ * @throws {Error} If the scanner cannot be started.
35
+ * @throws {Error} If the scanner is already running and `cancelPrevious` option is not set to `true`.
36
+ * @throws {Error} If any other error occurs while starting the scanner.
37
+ * @since 3.0.0
38
+ *
39
+ * @example
40
+ * // Start the barcode scanner with default options
41
+ * const scanner = await sos.hardware.barcodeScanner.start();
42
+ * // Listen for scanned data
43
+ * scanner.onData((data) => {
44
+ * console.log(`Scanned data: ${data}`);
45
+ * });
46
+ * // Listen for errors
47
+ * scanner.onError((error) => {
48
+ * console.error(`Scanner error: ${error.message}`);
49
+ * });
18
50
  */
19
- start(userOptions?: Omit<IBarcodeScannerOptions, 'scannerId'>): Promise<{
20
- stop: () => Promise<void>;
21
- onData: (listener: (data: string) => void) => void;
22
- onError: (listener: (error: Error) => void) => void;
23
- }>;
51
+ start(userOptions?: Omit<IBarcodeScannerOptions, 'scannerId'>): Promise<IBarcodeScannerResponse>;
24
52
  /** @internal */
25
53
  handleMessageData(msg: IBarcodeScannerDataMessage): void;
26
54
  private getMessage;