@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.
- package/CHANGELOG.md +71 -0
- package/api-docs/README.mdx +406 -0
- package/api-docs/enumerations/DeniedDevices.mdx +7 -0
- package/api-docs/enumerations/UserMediaStatus.mdx +49 -0
- package/api-docs/functions/applyContentHint.mdx +33 -0
- package/api-docs/functions/createAudioMixingProcess.mdx +20 -0
- package/api-docs/functions/createAudioStreamProcess.mdx +15 -0
- package/api-docs/functions/createGetDisplayMedia.mdx +26 -0
- package/api-docs/functions/createMedia.mdx +20 -0
- package/api-docs/functions/createMediaSignal.mdx +42 -0
- package/api-docs/functions/createMediaSignals.mdx +33 -0
- package/api-docs/functions/createPreviewStreamController.mdx +13 -0
- package/api-docs/functions/createVideoStreamProcess.mdx +13 -0
- package/api-docs/functions/deriveInitialPermissionStatus.mdx +14 -0
- package/api-docs/functions/getBlurKernelSize.mdx +25 -0
- package/api-docs/functions/getPermissionStatus.mdx +34 -0
- package/api-docs/functions/getTentBlurSize.mdx +24 -0
- package/api-docs/functions/isAnalyzerNodeInitProp.mdx +13 -0
- package/api-docs/functions/isAudioContentHint.mdx +13 -0
- package/api-docs/functions/isMedia.mdx +13 -0
- package/api-docs/functions/isNonNullObject.mdx +13 -0
- package/api-docs/functions/isUserMediaStatus.mdx +13 -0
- package/api-docs/functions/isVideoContentHint.mdx +13 -0
- package/api-docs/functions/isVideoStreamTrackProcessorAPIs.mdx +13 -0
- package/api-docs/functions/setLogger.mdx +13 -0
- package/api-docs/functions/toDeniedDevices.mdx +13 -0
- package/api-docs/interfaces/AudioDetectionSignals.mdx +6 -0
- package/api-docs/interfaces/AudioSignalDetectionOptions.mdx +6 -0
- package/api-docs/interfaces/DenoiseParams.mdx +9 -0
- package/api-docs/interfaces/ExtendedMediaTrackSettings.mdx +38 -0
- package/api-docs/interfaces/Media.mdx +316 -0
- package/api-docs/interfaces/MediaAttributes.mdx +19 -0
- package/api-docs/interfaces/MediaChangesSignals.mdx +15 -0
- package/api-docs/interfaces/MediaController.mdx +11 -0
- package/api-docs/interfaces/MediaInit.mdx +14 -0
- package/api-docs/interfaces/MediaOptions.mdx +10 -0
- package/api-docs/interfaces/MediaProps.mdx +9 -0
- package/api-docs/interfaces/MediaSettings.mdx +6 -0
- package/api-docs/interfaces/MediaTrack.mdx +121 -0
- package/api-docs/interfaces/MediaTrackInit.mdx +29 -0
- package/api-docs/interfaces/PreviewControllerProps.mdx +14 -0
- package/api-docs/interfaces/PreviewEventHandler.mdx +19 -0
- package/api-docs/interfaces/PreviewStreamController.mdx +350 -0
- package/api-docs/interfaces/PreviewStreamParams.mdx +15 -0
- package/api-docs/interfaces/VoiceActivityDetectionOptions.mdx +6 -0
- package/api-docs/type-aliases/AudioContentHint.mdx +3 -0
- package/api-docs/type-aliases/CreatePreviewStreamController.mdx +3 -0
- package/api-docs/type-aliases/ExtendedMediaTrackSettingsKey.mdx +3 -0
- package/api-docs/type-aliases/GeneratedMediaSignals.mdx +9 -0
- package/api-docs/type-aliases/GetDisplayMedia.mdx +3 -0
- package/api-docs/type-aliases/GetUserMediaProcess.mdx +19 -0
- package/api-docs/type-aliases/MediaSignals.mdx +3 -0
- package/api-docs/type-aliases/MediaSignalsOptional.mdx +3 -0
- package/api-docs/type-aliases/MediaSignalsRequired.mdx +3 -0
- package/api-docs/type-aliases/PreviewInput.mdx +3 -0
- package/api-docs/type-aliases/Process.mdx +19 -0
- package/api-docs/type-aliases/Segmenters.mdx +3 -0
- package/api-docs/type-aliases/TrackProcessor.mdx +3 -0
- package/api-docs/type-aliases/Unsubscribe.mdx +7 -0
- package/api-docs/type-aliases/UserMediaValidator.mdx +13 -0
- package/api-docs/type-aliases/VideoContentHint.mdx +3 -0
- package/api-docs/type-aliases/VideoRenderParams.mdx +17 -0
- package/api-docs/type-aliases/VideoStreamTrackProcessorAPIs.mdx +7 -0
- package/api-docs/variables/AUDIO_CONTENT_HINTS.mdx +17 -0
- package/api-docs/variables/REQUIRED_SIGNAL_KEYS.mdx +3 -0
- package/api-docs/variables/VIDEO_CONTENT_HINTS.mdx +17 -0
- package/api-docs/variables/areBothGranted.mdx +3 -0
- package/api-docs/variables/hasNoAudioDevices.mdx +3 -0
- package/api-docs/variables/hasNoDevice.mdx +3 -0
- package/api-docs/variables/hasNoVideoDevices.mdx +3 -0
- package/api-docs/variables/internalSignals.mdx +13 -0
- package/api-docs/variables/isAudioDeviceInUse.mdx +3 -0
- package/api-docs/variables/isDeviceInUse.mdx +3 -0
- package/api-docs/variables/isDevicesInUse.mdx +3 -0
- package/api-docs/variables/isFallback.mdx +3 -0
- package/api-docs/variables/isFallbackAudio.mdx +3 -0
- package/api-docs/variables/isFallbackVideo.mdx +3 -0
- package/api-docs/variables/isGranted.mdx +3 -0
- package/api-docs/variables/isGrantedAudio.mdx +3 -0
- package/api-docs/variables/isGrantedOnlyAudio.mdx +3 -0
- package/api-docs/variables/isGrantedOnlyAudioNoVideoDevices.mdx +3 -0
- package/api-docs/variables/isGrantedOnlyVideo.mdx +3 -0
- package/api-docs/variables/isGrantedOnlyVideoNoAudioDevices.mdx +3 -0
- package/api-docs/variables/isGrantedVideo.mdx +3 -0
- package/api-docs/variables/isInitial.mdx +3 -0
- package/api-docs/variables/isInitialPermissions.mdx +3 -0
- package/api-docs/variables/isInitialPermissionsGranted.mdx +3 -0
- package/api-docs/variables/isInitialPermissionsNotGranted.mdx +3 -0
- package/api-docs/variables/isOnlyAudioError.mdx +3 -0
- package/api-docs/variables/isOnlyVideoError.mdx +3 -0
- package/api-docs/variables/isOverConstrained.mdx +3 -0
- package/api-docs/variables/isPromptAudio.mdx +3 -0
- package/api-docs/variables/isPromptVideo.mdx +3 -0
- package/api-docs/variables/isRejected.mdx +3 -0
- package/api-docs/variables/isRejectedOnlyAudio.mdx +3 -0
- package/api-docs/variables/isRejectedOnlyVideo.mdx +3 -0
- package/api-docs/variables/isRequestPermissionNeeded.mdx +3 -0
- package/api-docs/variables/isUnknownError.mdx +3 -0
- package/api-docs/variables/isVideoDeviceInUse.mdx +3 -0
- package/dist/constants.d.ts +1 -0
- package/dist/constants.js +1 -0
- package/dist/index.d.ts +1 -1
- package/dist/index.js +1 -1
- package/dist/previewController.js +1 -1
- package/dist/types.d.ts +3 -1
- package/dist/userMedia.d.ts +4 -1
- package/dist/userMedia.js +15 -11
- package/dist/utils.d.ts +17 -6
- package/dist/utils.js +27 -13
- package/dist/videoProcessor.d.ts +3 -3
- package/dist/videoProcessor.js +172 -30
- 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,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) |
|