@pexip/media 20.3.4 → 21.0.0

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 (112) hide show
  1. package/CHANGELOG.md +71 -0
  2. package/api-docs/README.mdx +406 -0
  3. package/api-docs/enumerations/DeniedDevices.mdx +7 -0
  4. package/api-docs/enumerations/UserMediaStatus.mdx +49 -0
  5. package/api-docs/functions/applyContentHint.mdx +33 -0
  6. package/api-docs/functions/createAudioMixingProcess.mdx +20 -0
  7. package/api-docs/functions/createAudioStreamProcess.mdx +15 -0
  8. package/api-docs/functions/createGetDisplayMedia.mdx +26 -0
  9. package/api-docs/functions/createMedia.mdx +20 -0
  10. package/api-docs/functions/createMediaSignal.mdx +42 -0
  11. package/api-docs/functions/createMediaSignals.mdx +33 -0
  12. package/api-docs/functions/createPreviewStreamController.mdx +13 -0
  13. package/api-docs/functions/createVideoStreamProcess.mdx +13 -0
  14. package/api-docs/functions/deriveInitialPermissionStatus.mdx +14 -0
  15. package/api-docs/functions/getBlurKernelSize.mdx +25 -0
  16. package/api-docs/functions/getPermissionStatus.mdx +34 -0
  17. package/api-docs/functions/getTentBlurSize.mdx +24 -0
  18. package/api-docs/functions/isAnalyzerNodeInitProp.mdx +13 -0
  19. package/api-docs/functions/isAudioContentHint.mdx +13 -0
  20. package/api-docs/functions/isMedia.mdx +13 -0
  21. package/api-docs/functions/isNonNullObject.mdx +13 -0
  22. package/api-docs/functions/isUserMediaStatus.mdx +13 -0
  23. package/api-docs/functions/isVideoContentHint.mdx +13 -0
  24. package/api-docs/functions/isVideoStreamTrackProcessorAPIs.mdx +13 -0
  25. package/api-docs/functions/setLogger.mdx +13 -0
  26. package/api-docs/functions/toDeniedDevices.mdx +13 -0
  27. package/api-docs/interfaces/AudioDetectionSignals.mdx +6 -0
  28. package/api-docs/interfaces/AudioSignalDetectionOptions.mdx +6 -0
  29. package/api-docs/interfaces/DenoiseParams.mdx +9 -0
  30. package/api-docs/interfaces/ExtendedMediaTrackSettings.mdx +38 -0
  31. package/api-docs/interfaces/Media.mdx +316 -0
  32. package/api-docs/interfaces/MediaAttributes.mdx +19 -0
  33. package/api-docs/interfaces/MediaChangesSignals.mdx +15 -0
  34. package/api-docs/interfaces/MediaController.mdx +11 -0
  35. package/api-docs/interfaces/MediaInit.mdx +14 -0
  36. package/api-docs/interfaces/MediaOptions.mdx +10 -0
  37. package/api-docs/interfaces/MediaProps.mdx +9 -0
  38. package/api-docs/interfaces/MediaSettings.mdx +6 -0
  39. package/api-docs/interfaces/MediaTrack.mdx +121 -0
  40. package/api-docs/interfaces/MediaTrackInit.mdx +29 -0
  41. package/api-docs/interfaces/PreviewControllerProps.mdx +14 -0
  42. package/api-docs/interfaces/PreviewEventHandler.mdx +19 -0
  43. package/api-docs/interfaces/PreviewStreamController.mdx +350 -0
  44. package/api-docs/interfaces/PreviewStreamParams.mdx +15 -0
  45. package/api-docs/interfaces/VoiceActivityDetectionOptions.mdx +6 -0
  46. package/api-docs/type-aliases/AudioContentHint.mdx +3 -0
  47. package/api-docs/type-aliases/CreatePreviewStreamController.mdx +3 -0
  48. package/api-docs/type-aliases/ExtendedMediaTrackSettingsKey.mdx +3 -0
  49. package/api-docs/type-aliases/GeneratedMediaSignals.mdx +9 -0
  50. package/api-docs/type-aliases/GetDisplayMedia.mdx +3 -0
  51. package/api-docs/type-aliases/GetUserMediaProcess.mdx +19 -0
  52. package/api-docs/type-aliases/MediaSignals.mdx +3 -0
  53. package/api-docs/type-aliases/MediaSignalsOptional.mdx +3 -0
  54. package/api-docs/type-aliases/MediaSignalsRequired.mdx +3 -0
  55. package/api-docs/type-aliases/PreviewInput.mdx +3 -0
  56. package/api-docs/type-aliases/Process.mdx +19 -0
  57. package/api-docs/type-aliases/Segmenters.mdx +3 -0
  58. package/api-docs/type-aliases/TrackProcessor.mdx +3 -0
  59. package/api-docs/type-aliases/Unsubscribe.mdx +7 -0
  60. package/api-docs/type-aliases/UserMediaValidator.mdx +13 -0
  61. package/api-docs/type-aliases/VideoContentHint.mdx +3 -0
  62. package/api-docs/type-aliases/VideoRenderParams.mdx +17 -0
  63. package/api-docs/type-aliases/VideoStreamTrackProcessorAPIs.mdx +7 -0
  64. package/api-docs/variables/AUDIO_CONTENT_HINTS.mdx +17 -0
  65. package/api-docs/variables/REQUIRED_SIGNAL_KEYS.mdx +3 -0
  66. package/api-docs/variables/VIDEO_CONTENT_HINTS.mdx +17 -0
  67. package/api-docs/variables/areBothGranted.mdx +3 -0
  68. package/api-docs/variables/hasNoAudioDevices.mdx +3 -0
  69. package/api-docs/variables/hasNoDevice.mdx +3 -0
  70. package/api-docs/variables/hasNoVideoDevices.mdx +3 -0
  71. package/api-docs/variables/internalSignals.mdx +13 -0
  72. package/api-docs/variables/isAudioDeviceInUse.mdx +3 -0
  73. package/api-docs/variables/isDeviceInUse.mdx +3 -0
  74. package/api-docs/variables/isDevicesInUse.mdx +3 -0
  75. package/api-docs/variables/isFallback.mdx +3 -0
  76. package/api-docs/variables/isFallbackAudio.mdx +3 -0
  77. package/api-docs/variables/isFallbackVideo.mdx +3 -0
  78. package/api-docs/variables/isGranted.mdx +3 -0
  79. package/api-docs/variables/isGrantedAudio.mdx +3 -0
  80. package/api-docs/variables/isGrantedOnlyAudio.mdx +3 -0
  81. package/api-docs/variables/isGrantedOnlyAudioNoVideoDevices.mdx +3 -0
  82. package/api-docs/variables/isGrantedOnlyVideo.mdx +3 -0
  83. package/api-docs/variables/isGrantedOnlyVideoNoAudioDevices.mdx +3 -0
  84. package/api-docs/variables/isGrantedVideo.mdx +3 -0
  85. package/api-docs/variables/isInitial.mdx +3 -0
  86. package/api-docs/variables/isInitialPermissions.mdx +3 -0
  87. package/api-docs/variables/isInitialPermissionsGranted.mdx +3 -0
  88. package/api-docs/variables/isInitialPermissionsNotGranted.mdx +3 -0
  89. package/api-docs/variables/isOnlyAudioError.mdx +3 -0
  90. package/api-docs/variables/isOnlyVideoError.mdx +3 -0
  91. package/api-docs/variables/isOverConstrained.mdx +3 -0
  92. package/api-docs/variables/isPromptAudio.mdx +3 -0
  93. package/api-docs/variables/isPromptVideo.mdx +3 -0
  94. package/api-docs/variables/isRejected.mdx +3 -0
  95. package/api-docs/variables/isRejectedOnlyAudio.mdx +3 -0
  96. package/api-docs/variables/isRejectedOnlyVideo.mdx +3 -0
  97. package/api-docs/variables/isRequestPermissionNeeded.mdx +3 -0
  98. package/api-docs/variables/isUnknownError.mdx +3 -0
  99. package/api-docs/variables/isVideoDeviceInUse.mdx +3 -0
  100. package/dist/constants.d.ts +1 -0
  101. package/dist/constants.js +1 -0
  102. package/dist/index.d.ts +1 -1
  103. package/dist/index.js +1 -1
  104. package/dist/previewController.js +1 -1
  105. package/dist/types.d.ts +3 -1
  106. package/dist/userMedia.d.ts +4 -1
  107. package/dist/userMedia.js +15 -11
  108. package/dist/utils.d.ts +17 -6
  109. package/dist/utils.js +27 -13
  110. package/dist/videoProcessor.d.ts +3 -3
  111. package/dist/videoProcessor.js +172 -30
  112. package/package.json +17 -12
@@ -0,0 +1,316 @@
1
+ ## Extends
2
+
3
+ - [`MediaAttributes`](MediaAttributes.mdx)
4
+
5
+ ## Properties
6
+
7
+ | Property | Modifier | Type | Description | Inherited from |
8
+ | ------ | ------ | ------ | ------ | ------ |
9
+ | <a id="active"></a> `active` | `readonly` | `boolean` | Indicating whether the media is active A stream is considered active if at least one of its MediaStreamTracks does not have its property MediaStreamTrack.readyState set to ended. Once every track has ended, the stream's active property becomes false. | [`MediaAttributes`](MediaAttributes.mdx).[`active`](MediaAttributes.mdx#active) |
10
+ | <a id="id"></a> `id` | `readonly` | `string` | A string containing a 36-character universally unique identifier (UUID) for the object. | [`MediaAttributes`](MediaAttributes.mdx).[`id`](MediaAttributes.mdx#id) |
11
+ | <a id="devices"></a> `devices` | `public` | `IndexedDevices` | The devices used for the media | [`MediaAttributes`](MediaAttributes.mdx).[`devices`](MediaAttributes.mdx#devices) |
12
+ | <a id="stream"></a> `stream` | `public` | `MediaStream` | Media stream for the media | [`MediaAttributes`](MediaAttributes.mdx).[`stream`](MediaAttributes.mdx#stream) |
13
+ | <a id="expectedaudioinput"></a> `expectedAudioInput?` | `public` | `MediaDeviceInfoLike` | The audio input device which is expected to be used for the current stream based on the provided constraints | [`MediaAttributes`](MediaAttributes.mdx).[`expectedAudioInput`](MediaAttributes.mdx#expectedaudioinput) |
14
+ | <a id="expectedvideoinput"></a> `expectedVideoInput?` | `public` | `MediaDeviceInfoLike` | The video input device which is expected to be used for the current stream based on the provided constraints | [`MediaAttributes`](MediaAttributes.mdx).[`expectedVideoInput`](MediaAttributes.mdx#expectedvideoinput) |
15
+ | <a id="status"></a> `status` | `public` | [`UserMediaStatus`](../enumerations/UserMediaStatus.mdx) | The status of the media | [`MediaAttributes`](MediaAttributes.mdx).[`status`](MediaAttributes.mdx#status) |
16
+ | <a id="audiomuted"></a> `audioMuted` | `public` | `boolean` \| `undefined` | Current mute state of audio track `undefined` means there is no such track from the stream | [`MediaAttributes`](MediaAttributes.mdx).[`audioMuted`](MediaAttributes.mdx#audiomuted) |
17
+ | <a id="videomuted"></a> `videoMuted` | `public` | `boolean` \| `undefined` | Current mute state of video track `undefined` means there is no such track from the stream | [`MediaAttributes`](MediaAttributes.mdx).[`videoMuted`](MediaAttributes.mdx#videomuted) |
18
+ | <a id="audioinput"></a> `audioInput?` | `public` | `MediaDeviceInfoLike` | Audio input device is used for the audio track from the current stream | [`MediaAttributes`](MediaAttributes.mdx).[`audioInput`](MediaAttributes.mdx#audioinput) |
19
+ | <a id="videoinput"></a> `videoInput?` | `public` | `MediaDeviceInfoLike` | Video input device is used for the video track from the current stream | [`MediaAttributes`](MediaAttributes.mdx).[`videoInput`](MediaAttributes.mdx#videoinput) |
20
+
21
+ ## Methods
22
+
23
+ ### muteAudio()
24
+
25
+ ```ts
26
+ muteAudio(mute): void;
27
+ ```
28
+
29
+ mute/unmute the audio track
30
+
31
+ #### Parameters
32
+
33
+ | Parameter | Type |
34
+ | ------ | ------ |
35
+ | `mute` | `boolean` |
36
+
37
+ #### Returns
38
+
39
+ `void`
40
+
41
+ ***
42
+
43
+ ### muteVideo()
44
+
45
+ ```ts
46
+ muteVideo(mute): void;
47
+ ```
48
+
49
+ mute/unmute the video track
50
+
51
+ #### Parameters
52
+
53
+ | Parameter | Type |
54
+ | ------ | ------ |
55
+ | `mute` | `boolean` |
56
+
57
+ #### Returns
58
+
59
+ `void`
60
+
61
+ ***
62
+
63
+ ### applyConstraints()
64
+
65
+ ```ts
66
+ applyConstraints(constraints): Promise<void>;
67
+ ```
68
+
69
+ Apply the constraints to the current media
70
+
71
+ #### Parameters
72
+
73
+ | Parameter | Type |
74
+ | ------ | ------ |
75
+ | `constraints` | `MediaDeviceRequest` |
76
+
77
+ #### Returns
78
+
79
+ `Promise`\<`void`\>
80
+
81
+ ***
82
+
83
+ ### release()
84
+
85
+ ```ts
86
+ release(): Promise<void>;
87
+ ```
88
+
89
+ Release the media resources, e.g. camera/microphone
90
+
91
+ #### Returns
92
+
93
+ `Promise`\<`void`\>
94
+
95
+ ***
96
+
97
+ ### getConstraints()
98
+
99
+ ```ts
100
+ getConstraints(): MediaDeviceRequest;
101
+ ```
102
+
103
+ #### Returns
104
+
105
+ `MediaDeviceRequest`
106
+
107
+ ***
108
+
109
+ ### setOriginalConstraints()
110
+
111
+ ```ts
112
+ setOriginalConstraints(constraints): void;
113
+ ```
114
+
115
+ #### Parameters
116
+
117
+ | Parameter | Type |
118
+ | ------ | ------ |
119
+ | `constraints` | `MediaDeviceRequest` |
120
+
121
+ #### Returns
122
+
123
+ `void`
124
+
125
+ ***
126
+
127
+ ### getOriginalConstraints()
128
+
129
+ ```ts
130
+ getOriginalConstraints(): MediaDeviceRequest;
131
+ ```
132
+
133
+ #### Returns
134
+
135
+ `MediaDeviceRequest`
136
+
137
+ ***
138
+
139
+ ### isAudioInputUnavailable()
140
+
141
+ ```ts
142
+ isAudioInputUnavailable(): boolean;
143
+ ```
144
+
145
+ #### Returns
146
+
147
+ `boolean`
148
+
149
+ ***
150
+
151
+ ### isVideoInputUnavailable()
152
+
153
+ ```ts
154
+ isVideoInputUnavailable(): boolean;
155
+ ```
156
+
157
+ #### Returns
158
+
159
+ `boolean`
160
+
161
+ ***
162
+
163
+ ### requestedAudio()
164
+
165
+ ```ts
166
+ requestedAudio(): boolean;
167
+ ```
168
+
169
+ #### Returns
170
+
171
+ `boolean`
172
+
173
+ ***
174
+
175
+ ### requestedVideo()
176
+
177
+ ```ts
178
+ requestedVideo(): boolean;
179
+ ```
180
+
181
+ #### Returns
182
+
183
+ `boolean`
184
+
185
+ ***
186
+
187
+ ### getSettings()
188
+
189
+ ```ts
190
+ getSettings(): MediaSettings;
191
+ ```
192
+
193
+ #### Returns
194
+
195
+ [`MediaSettings`](MediaSettings.mdx)
196
+
197
+ ***
198
+
199
+ ### toJSON()
200
+
201
+ ```ts
202
+ toJSON(): unknown;
203
+ ```
204
+
205
+ #### Returns
206
+
207
+ `unknown`
208
+
209
+ ***
210
+
211
+ ### getTracks()
212
+
213
+ ```ts
214
+ getTracks(): MediaTrack[];
215
+ ```
216
+
217
+ #### Returns
218
+
219
+ [`MediaTrack`](MediaTrack.mdx)[]
220
+
221
+ ***
222
+
223
+ ### getAudioTracks()
224
+
225
+ ```ts
226
+ getAudioTracks(): MediaTrack[];
227
+ ```
228
+
229
+ #### Returns
230
+
231
+ [`MediaTrack`](MediaTrack.mdx)[]
232
+
233
+ ***
234
+
235
+ ### getVideoTracks()
236
+
237
+ ```ts
238
+ getVideoTracks(): MediaTrack[];
239
+ ```
240
+
241
+ #### Returns
242
+
243
+ [`MediaTrack`](MediaTrack.mdx)[]
244
+
245
+ ***
246
+
247
+ ### addTrack()
248
+
249
+ ```ts
250
+ addTrack(track): void;
251
+ ```
252
+
253
+ #### Parameters
254
+
255
+ | Parameter | Type |
256
+ | ------ | ------ |
257
+ | `track` | [`MediaTrack`](MediaTrack.mdx) |
258
+
259
+ #### Returns
260
+
261
+ `void`
262
+
263
+ ***
264
+
265
+ ### isCurrentTrack()
266
+
267
+ ```ts
268
+ isCurrentTrack(track): boolean;
269
+ ```
270
+
271
+ #### Parameters
272
+
273
+ | Parameter | Type |
274
+ | ------ | ------ |
275
+ | `track` | [`MediaTrack`](MediaTrack.mdx) |
276
+
277
+ #### Returns
278
+
279
+ `boolean`
280
+
281
+ ***
282
+
283
+ ### removeTrack()
284
+
285
+ ```ts
286
+ removeTrack(track): void;
287
+ ```
288
+
289
+ #### Parameters
290
+
291
+ | Parameter | Type |
292
+ | ------ | ------ |
293
+ | `track` | [`MediaTrack`](MediaTrack.mdx) |
294
+
295
+ #### Returns
296
+
297
+ `void`
298
+
299
+ ***
300
+
301
+ ### clone()
302
+
303
+ ```ts
304
+ clone(signals?, label?): Media;
305
+ ```
306
+
307
+ #### Parameters
308
+
309
+ | Parameter | Type |
310
+ | ------ | ------ |
311
+ | `signals?` | [`MediaSignals`](../type-aliases/MediaSignals.mdx) |
312
+ | `label?` | `string` |
313
+
314
+ #### Returns
315
+
316
+ `Media`
@@ -0,0 +1,19 @@
1
+ ## Extended by
2
+
3
+ - [`Media`](Media.mdx)
4
+
5
+ ## Properties
6
+
7
+ | Property | Modifier | Type | Description |
8
+ | ------ | ------ | ------ | ------ |
9
+ | <a id="active"></a> `active` | `readonly` | `boolean` | Indicating whether the media is active A stream is considered active if at least one of its MediaStreamTracks does not have its property MediaStreamTrack.readyState set to ended. Once every track has ended, the stream's active property becomes false. |
10
+ | <a id="id"></a> `id` | `readonly` | `string` | A string containing a 36-character universally unique identifier (UUID) for the object. |
11
+ | <a id="devices"></a> `devices` | `public` | `IndexedDevices` | The devices used for the media |
12
+ | <a id="stream"></a> `stream` | `public` | `MediaStream` | Media stream for the media |
13
+ | <a id="expectedaudioinput"></a> `expectedAudioInput?` | `public` | `MediaDeviceInfoLike` | The audio input device which is expected to be used for the current stream based on the provided constraints |
14
+ | <a id="expectedvideoinput"></a> `expectedVideoInput?` | `public` | `MediaDeviceInfoLike` | The video input device which is expected to be used for the current stream based on the provided constraints |
15
+ | <a id="status"></a> `status` | `public` | [`UserMediaStatus`](../enumerations/UserMediaStatus.mdx) | The status of the media |
16
+ | <a id="audiomuted"></a> `audioMuted` | `public` | `boolean` \| `undefined` | Current mute state of audio track `undefined` means there is no such track from the stream |
17
+ | <a id="videomuted"></a> `videoMuted` | `public` | `boolean` \| `undefined` | Current mute state of video track `undefined` means there is no such track from the stream |
18
+ | <a id="audioinput"></a> `audioInput?` | `public` | `MediaDeviceInfoLike` | Audio input device is used for the audio track from the current stream |
19
+ | <a id="videoinput"></a> `videoInput?` | `public` | `MediaDeviceInfoLike` | Video input device is used for the video track from the current stream |
@@ -0,0 +1,15 @@
1
+ ## Properties
2
+
3
+ | Property | Type |
4
+ | ------ | ------ |
5
+ | <a id="onaddtrack"></a> `onAddTrack` | `Signal`\<`MediaStreamTrack`\> |
6
+ | <a id="ondeviceschanged"></a> `onDevicesChanged` | `Signal`\<`IndexedDevices`\> |
7
+ | <a id="onmediachanged"></a> `onMediaChanged` | `Signal`\<[`Media`](Media.mdx) \| `undefined`\> |
8
+ | <a id="onmediatrackmuted"></a> `onMediaTrackMuted` | `Signal`\<[`MediaTrack`](MediaTrack.mdx)\> |
9
+ | <a id="onmediatrackresumed"></a> `onMediaTrackResumed` | `Signal`\<[`MediaTrack`](MediaTrack.mdx)\> |
10
+ | <a id="onmediatrackstopped"></a> `onMediaTrackStopped` | `Signal`\<[`MediaTrack`](MediaTrack.mdx)\> |
11
+ | <a id="onmediatracksuspended"></a> `onMediaTrackSuspended` | `Signal`\<[`MediaTrack`](MediaTrack.mdx)\> |
12
+ | <a id="onremovetrack"></a> `onRemoveTrack` | `Signal`\<`MediaStreamTrack`\> |
13
+ | <a id="onstatuschanged"></a> `onStatusChanged` | `Signal`\<[`UserMediaStatus`](../enumerations/UserMediaStatus.mdx)\> |
14
+ | <a id="onupdatingaudio"></a> `onUpdatingAudio` | `Signal`\<`boolean`\> |
15
+ | <a id="onupdatingvideo"></a> `onUpdatingVideo` | `Signal`\<`boolean`\> |
@@ -0,0 +1,11 @@
1
+ ## Properties
2
+
3
+ | Property | Modifier | Type | Description |
4
+ | ------ | ------ | ------ | ------ |
5
+ | <a id="updatingaudio"></a> `updatingAudio` | `readonly` | `boolean` | - |
6
+ | <a id="updatingvideo"></a> `updatingVideo` | `readonly` | `boolean` | - |
7
+ | <a id="media"></a> `media?` | `readonly` | [`Media`](Media.mdx) | Current Media |
8
+ | <a id="devices"></a> `devices` | `readonly` | `IndexedDevices` | Current device list |
9
+ | <a id="getusermedia"></a> `getUserMedia` | `public` | (`constraints`) => `void` | Execute the media pipeline immediately with provided constraints **See** MediaDeviceRequest |
10
+ | <a id="getusermediaasync"></a> `getUserMediaAsync` | `public` | (`constraints`) => `Promise`\<`void`\> | Execute the media pipeline immediately with provided constraints. An explicit version of `getUserMedia` to make it possible to chain other async actions **See** MediaDeviceRequest |
11
+ | <a id="tryandgetusermedia"></a> `tryAndGetUserMedia` | `public` | (`constraints`) => `void` | Cross-check PermissionState and available devices before requesting user media, the request will be skipped if there is no granted device. |
@@ -0,0 +1,14 @@
1
+ ## Properties
2
+
3
+ | Property | Type |
4
+ | ------ | ------ |
5
+ | <a id="constraints"></a> `constraints` | `MediaDeviceRequest` |
6
+ | <a id="permission"></a> `permission` | `object` |
7
+ | `permission.audio` | `PermissionState` |
8
+ | `permission.video` | `PermissionState` |
9
+ | <a id="originalconstraints"></a> `originalConstraints?` | `MediaDeviceRequest` |
10
+ | <a id="tracks"></a> `tracks` | [`MediaTrack`](MediaTrack.mdx)[] |
11
+ | <a id="devices"></a> `devices` | `IndexedDevices` |
12
+ | <a id="status"></a> `status` | [`UserMediaStatus`](../enumerations/UserMediaStatus.mdx) |
13
+ | <a id="stream"></a> `stream` | `MediaStream` \| `undefined` |
14
+ | <a id="signals"></a> `signals?` | [`MediaSignals`](../type-aliases/MediaSignals.mdx) |
@@ -0,0 +1,10 @@
1
+ ## Properties
2
+
3
+ | Property | Type | Description |
4
+ | ------ | ------ | ------ |
5
+ | <a id="signals"></a> `signals` | [`MediaSignals`](../type-aliases/MediaSignals.mdx) | Media signals to be used for the module **See** MediaSignals |
6
+ | <a id="audioprocessors"></a> `audioProcessors` | [`TrackProcessor`](../type-aliases/TrackProcessor.mdx)[] | Media Processors |
7
+ | <a id="videoprocessors"></a> `videoProcessors` | [`TrackProcessor`](../type-aliases/TrackProcessor.mdx)[] | - |
8
+ | <a id="stopvideotrackasmute"></a> `stopVideoTrackAsMute?` | () => `boolean` | - |
9
+ | <a id="getmutestate"></a> `getMuteState` | () => `DeviceMuteState` | A function to get the devices' mute state |
10
+ | <a id="getdefaultconstraints"></a> `getDefaultConstraints?` | () => `object` | Pass default constraints to use with get media wrappers |
@@ -0,0 +1,9 @@
1
+ ## Properties
2
+
3
+ | Property | Type | Description |
4
+ | ------ | ------ | ------ |
5
+ | <a id="media"></a> `media?` | [`Media`](Media.mdx) | Current media |
6
+ | <a id="devices"></a> `devices` | `IndexedDevices` | Current device |
7
+ | <a id="discardmedia"></a> `discardMedia` | `boolean` | When should we discard the requested MediaStream |
8
+ | <a id="updatingaudio"></a> `updatingAudio` | `boolean` | - |
9
+ | <a id="updatingvideo"></a> `updatingVideo` | `boolean` | - |
@@ -0,0 +1,6 @@
1
+ ## Properties
2
+
3
+ | Property | Type |
4
+ | ------ | ------ |
5
+ | <a id="audio"></a> `audio?` | [`ExtendedMediaTrackSettings`](ExtendedMediaTrackSettings.mdx) |
6
+ | <a id="video"></a> `video?` | [`ExtendedMediaTrackSettings`](ExtendedMediaTrackSettings.mdx) |
@@ -0,0 +1,121 @@
1
+ ## Properties
2
+
3
+ | Property | Modifier | Type | Description |
4
+ | ------ | ------ | ------ | ------ |
5
+ | <a id="id"></a> `id` | `readonly` | `string` | A unique identifier for the track same as `MediaStreamTrack.id` if `track` is available otherwise it uses the `id` from the construction or the `kind`. **See** MediaTrackInit |
6
+ | <a id="stopped"></a> `stopped?` | `readonly` | `boolean` | It maps to MediaStreamTrack['readyState'] When `true` the track's `readyState` is `ended`, `false` means `live` otherwise the track is not available |
7
+ | <a id="suspended"></a> `suspended?` | `readonly` | `boolean` | Indicate that the media has been suspended by the User Agent, and it could happen at any time. `undefined` means the track is not available |
8
+ | <a id="kind"></a> `kind` | `readonly` | `"audioinput"` \| `"videoinput"` | - |
9
+ | <a id="label"></a> `label?` | `readonly` | `string` | - |
10
+ | <a id="previousmediatrack"></a> `previousMediaTrack?` | `readonly` | `MediaTrack` | - |
11
+ | <a id="track"></a> `track?` | `readonly` | `MediaStreamTrack` | The MediaStreamTrack object representing the track **See** https://developer.mozilla.org/en-US/docs/Web/API/MediaStreamTrack |
12
+ | <a id="input"></a> `input?` | `readonly` | `MediaDeviceInfoLike` | The `MediaDeviceInfo` object representing the device that the track is connected to. **See** https://developer.mozilla.org/en-US/docs/Web/API/MediaDeviceInfo |
13
+ | <a id="expectedinput"></a> `expectedInput?` | `readonly` | `MediaDeviceInfoLike` | The `MediaDeviceInfo` object representing the device that the track is expected to be connected to. **See** https://developer.mozilla.org/en-US/docs/Web/API/MediaDeviceInfo |
14
+ | <a id="muted"></a> `muted?` | `public` | `boolean` | The current mute state of the track. `undefined` means the track is not available |
15
+ | <a id="source"></a> `source` | `readonly` | `MediaTrack` | The source track that it is originated from |
16
+
17
+ ## Methods
18
+
19
+ ### mute()
20
+
21
+ ```ts
22
+ mute(toMute, soft?): void;
23
+ ```
24
+
25
+ Mute the track
26
+
27
+ #### Parameters
28
+
29
+ | Parameter | Type | Description |
30
+ | ------ | ------ | ------ |
31
+ | `toMute` | `boolean` | `true` to mute the track, `false` to unmute |
32
+ | `soft?` | `boolean` | `true` to indicate a soft mute i.e. setting the track to NOT `enabled` `false` or `undefined` for default mute |
33
+
34
+ #### Returns
35
+
36
+ `void`
37
+
38
+ ***
39
+
40
+ ### getSettings()
41
+
42
+ ```ts
43
+ getSettings(): ExtendedMediaTrackSettings;
44
+ ```
45
+
46
+ #### Returns
47
+
48
+ [`ExtendedMediaTrackSettings`](ExtendedMediaTrackSettings.mdx)
49
+
50
+ ***
51
+
52
+ ### getConstraints()
53
+
54
+ ```ts
55
+ getConstraints(): InputDeviceConstraint;
56
+ ```
57
+
58
+ #### Returns
59
+
60
+ `InputDeviceConstraint`
61
+
62
+ ***
63
+
64
+ ### applyConstraints()
65
+
66
+ ```ts
67
+ applyConstraints(constraints): Promise<void>;
68
+ ```
69
+
70
+ #### Parameters
71
+
72
+ | Parameter | Type |
73
+ | ------ | ------ |
74
+ | `constraints` | `InputDeviceConstraint` |
75
+
76
+ #### Returns
77
+
78
+ `Promise`\<`void`\>
79
+
80
+ ***
81
+
82
+ ### release()
83
+
84
+ ```ts
85
+ release(): Promise<void>;
86
+ ```
87
+
88
+ #### Returns
89
+
90
+ `Promise`\<`void`\>
91
+
92
+ ***
93
+
94
+ ### clone()
95
+
96
+ ```ts
97
+ clone(signals?, label?): MediaTrack;
98
+ ```
99
+
100
+ #### Parameters
101
+
102
+ | Parameter | Type |
103
+ | ------ | ------ |
104
+ | `signals?` | [`MediaSignals`](../type-aliases/MediaSignals.mdx) |
105
+ | `label?` | `string` |
106
+
107
+ #### Returns
108
+
109
+ `MediaTrack`
110
+
111
+ ***
112
+
113
+ ### toJSON()
114
+
115
+ ```ts
116
+ toJSON(): unknown;
117
+ ```
118
+
119
+ #### Returns
120
+
121
+ `unknown`
@@ -0,0 +1,29 @@
1
+ ## Extends
2
+
3
+ - `Partial`\<`Omit`\<[`MediaTrack`](MediaTrack.mdx), `"mute"`\>\>
4
+
5
+ ## Properties
6
+
7
+ | Property | Modifier | Type | Description | Overrides | Inherited from |
8
+ | ------ | ------ | ------ | ------ | ------ | ------ |
9
+ | <a id="id"></a> `id?` | `readonly` | `string` | A unique identifier for the track same as `MediaStreamTrack.id` if `track` is available otherwise it uses the `id` from the construction or the `kind`. **See** MediaTrackInit | - | [`MediaTrack`](MediaTrack.mdx).[`id`](MediaTrack.mdx#id) |
10
+ | <a id="stopped"></a> `stopped?` | `readonly` | `boolean` | It maps to MediaStreamTrack['readyState'] When `true` the track's `readyState` is `ended`, `false` means `live` otherwise the track is not available | - | [`MediaTrack`](MediaTrack.mdx).[`stopped`](MediaTrack.mdx#stopped) |
11
+ | <a id="suspended"></a> `suspended?` | `readonly` | `boolean` | Indicate that the media has been suspended by the User Agent, and it could happen at any time. `undefined` means the track is not available | - | [`MediaTrack`](MediaTrack.mdx).[`suspended`](MediaTrack.mdx#suspended) |
12
+ | <a id="label"></a> `label?` | `readonly` | `string` | - | - | [`MediaTrack`](MediaTrack.mdx).[`label`](MediaTrack.mdx#label) |
13
+ | <a id="previousmediatrack"></a> `previousMediaTrack?` | `readonly` | [`MediaTrack`](MediaTrack.mdx) | - | - | [`MediaTrack`](MediaTrack.mdx).[`previousMediaTrack`](MediaTrack.mdx#previousmediatrack) |
14
+ | <a id="track"></a> `track?` | `readonly` | `MediaStreamTrack` | The MediaStreamTrack object representing the track **See** https://developer.mozilla.org/en-US/docs/Web/API/MediaStreamTrack | - | [`MediaTrack`](MediaTrack.mdx).[`track`](MediaTrack.mdx#track) |
15
+ | <a id="muted"></a> `muted?` | `public` | `boolean` | The current mute state of the track. `undefined` means the track is not available | - | [`MediaTrack`](MediaTrack.mdx).[`muted`](MediaTrack.mdx#muted) |
16
+ | <a id="source"></a> `source?` | `readonly` | [`MediaTrack`](MediaTrack.mdx) | The source track that it is originated from | - | [`MediaTrack`](MediaTrack.mdx).[`source`](MediaTrack.mdx#source) |
17
+ | <a id="getsettings"></a> `getSettings?` | `public` | () => [`ExtendedMediaTrackSettings`](ExtendedMediaTrackSettings.mdx) | - | - | [`MediaTrack`](MediaTrack.mdx).[`getSettings`](MediaTrack.mdx#getsettings) |
18
+ | <a id="getconstraints"></a> `getConstraints?` | `public` | () => `InputDeviceConstraint` | - | - | [`MediaTrack`](MediaTrack.mdx).[`getConstraints`](MediaTrack.mdx#getconstraints) |
19
+ | <a id="applyconstraints"></a> `applyConstraints?` | `public` | (`constraints`) => `Promise`\<`void`\> | - | - | [`MediaTrack`](MediaTrack.mdx).[`applyConstraints`](MediaTrack.mdx#applyconstraints) |
20
+ | <a id="release"></a> `release?` | `public` | () => `Promise`\<`void`\> | - | - | [`MediaTrack`](MediaTrack.mdx).[`release`](MediaTrack.mdx#release) |
21
+ | <a id="clone"></a> `clone?` | `public` | (`signals?`, `label?`) => [`MediaTrack`](MediaTrack.mdx) | - | - | [`MediaTrack`](MediaTrack.mdx).[`clone`](MediaTrack.mdx#clone) |
22
+ | <a id="tojson"></a> `toJSON?` | `public` | () => `unknown` | - | - | [`MediaTrack`](MediaTrack.mdx).[`toJSON`](MediaTrack.mdx#tojson) |
23
+ | <a id="kind"></a> `kind` | `public` | `"audioinput"` \| `"videoinput"` | - | [`MediaTrack`](MediaTrack.mdx).[`kind`](MediaTrack.mdx#kind) | - |
24
+ | <a id="input"></a> `input` | `public` | `MediaDeviceInfoLike` \| `undefined` | The `MediaDeviceInfo` object representing the device that the track is connected to. **See** https://developer.mozilla.org/en-US/docs/Web/API/MediaDeviceInfo | [`MediaTrack`](MediaTrack.mdx).[`input`](MediaTrack.mdx#input) | - |
25
+ | <a id="expectedinput"></a> `expectedInput?` | `public` | `MediaDeviceInfoLike` | The `MediaDeviceInfo` object representing the device that the track is expected to be connected to. **See** https://developer.mozilla.org/en-US/docs/Web/API/MediaDeviceInfo | [`MediaTrack`](MediaTrack.mdx).[`expectedInput`](MediaTrack.mdx#expectedinput) | - |
26
+ | <a id="constraints"></a> `constraints` | `public` | `InputDeviceConstraint` | - | - | - |
27
+ | <a id="overridemute"></a> `overrideMute?` | `public` | `boolean` | - | - | - |
28
+ | <a id="signals"></a> `signals?` | `public` | [`MediaSignals`](../type-aliases/MediaSignals.mdx) | - | - | - |
29
+ | <a id="mute"></a> `mute?` | `public` | (`toMute`, `self`, `soft?`) => `void` | Overriding Mute the track | - | - |
@@ -0,0 +1,14 @@
1
+ ## Properties
2
+
3
+ | Property | Type |
4
+ | ------ | ------ |
5
+ | <a id="media"></a> `media` | [`Media`](Media.mdx) \| `undefined` |
6
+ | <a id="audioinput"></a> `audioInput?` | `MediaDeviceInfoLike` |
7
+ | <a id="videoinput"></a> `videoInput?` | `MediaDeviceInfoLike` |
8
+ | <a id="updatingpreviewaudio"></a> `updatingPreviewAudio` | `boolean` |
9
+ | <a id="updatingpreviewvideo"></a> `updatingPreviewVideo` | `boolean` |
10
+ | <a id="updatingmain"></a> `updatingMain` | `boolean` |
11
+ | <a id="originalmainaudioinput"></a> `originalMainAudioInput?` | `MediaDeviceInfoLike` |
12
+ | <a id="discardmedia"></a> `discardMedia` | `boolean` |
13
+ | <a id="initialized"></a> `initialized` | `boolean` |
14
+ | <a id="signals"></a> `signals` | [`MediaSignals`](../type-aliases/MediaSignals.mdx) |
@@ -0,0 +1,19 @@
1
+ ## Properties
2
+
3
+ | Property | Type |
4
+ | ------ | ------ |
5
+ | <a id="audioinput"></a> `audioInput?` | `EventCallback`\<[`PreviewInput`](../type-aliases/PreviewInput.mdx)\> |
6
+ | <a id="videoinput"></a> `videoInput?` | `EventCallback`\<[`PreviewInput`](../type-aliases/PreviewInput.mdx)\> |
7
+ | <a id="media"></a> `media?` | `EventCallback`\<[`Media`](Media.mdx)\> |
8
+ | <a id="videoinputerror"></a> `videoInputError?` | `EventErrorCallback` |
9
+ | <a id="audioinputerror"></a> `audioInputError?` | `EventErrorCallback` |
10
+ | <a id="applychangeserror"></a> `applyChangesError?` | `EventErrorCallback` |
11
+ | <a id="revertchangeserror"></a> `revertChangesError?` | `EventErrorCallback` |
12
+ | <a id="audiomuted"></a> `audioMuted?` | `EventCallback`\<`boolean` \| `undefined`\> |
13
+ | <a id="audiosuspended"></a> `audioSuspended?` | `EventCallback`\<`boolean` \| `undefined`\> |
14
+ | <a id="updatingmain"></a> `updatingMain?` | `EventCallback`\<`boolean`\> |
15
+ | <a id="updatingpreviewaudio"></a> `updatingPreviewAudio?` | `EventCallback`\<`boolean`\> |
16
+ | <a id="updatingpreviewvideo"></a> `updatingPreviewVideo?` | `EventCallback`\<`boolean`\> |
17
+ | <a id="videomuted"></a> `videoMuted?` | `EventCallback`\<`boolean` \| `undefined`\> |
18
+ | <a id="videosuspended"></a> `videoSuspended?` | `EventCallback`\<`boolean` \| `undefined`\> |
19
+ | <a id="unsubscribemain"></a> `unsubscribeMain?` | [`Unsubscribe`](../type-aliases/Unsubscribe.mdx) |