@pexip/media 20.3.3 → 20.3.5
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 +20 -0
- package/api-docs/README.mdx +404 -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/getPermissionStatus.mdx +34 -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 +15 -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/package.json +17 -12
|
@@ -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) |
|
|
@@ -0,0 +1,350 @@
|
|
|
1
|
+
## Properties
|
|
2
|
+
|
|
3
|
+
| Property | Type |
|
|
4
|
+
| ------ | ------ |
|
|
5
|
+
| <a id="media"></a> `media` | [`Media`](Media.mdx) \| `undefined` |
|
|
6
|
+
| <a id="audioinputchanged"></a> `audioInputChanged` | `boolean` |
|
|
7
|
+
| <a id="videoinputchanged"></a> `videoInputChanged` | `boolean` |
|
|
8
|
+
| <a id="inputchanged"></a> `inputChanged` | `boolean` |
|
|
9
|
+
| <a id="audioinput"></a> `audioInput` | [`PreviewInput`](../type-aliases/PreviewInput.mdx) |
|
|
10
|
+
| <a id="videoinput"></a> `videoInput` | [`PreviewInput`](../type-aliases/PreviewInput.mdx) |
|
|
11
|
+
| <a id="updatingmain"></a> `updatingMain` | `boolean` |
|
|
12
|
+
| <a id="updatingpreviewaudio"></a> `updatingPreviewAudio` | `boolean` |
|
|
13
|
+
| <a id="updatingpreviewvideo"></a> `updatingPreviewVideo` | `boolean` |
|
|
14
|
+
| <a id="cleanup"></a> `cleanup` | () => `Promise`\<`void`\> |
|
|
15
|
+
|
|
16
|
+
## Methods
|
|
17
|
+
|
|
18
|
+
### updatePreviewInput()
|
|
19
|
+
|
|
20
|
+
```ts
|
|
21
|
+
updatePreviewInput(input): void;
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
#### Parameters
|
|
25
|
+
|
|
26
|
+
| Parameter | Type |
|
|
27
|
+
| ------ | ------ |
|
|
28
|
+
| `input` | [`PreviewInput`](../type-aliases/PreviewInput.mdx) |
|
|
29
|
+
|
|
30
|
+
#### Returns
|
|
31
|
+
|
|
32
|
+
`void`
|
|
33
|
+
|
|
34
|
+
***
|
|
35
|
+
|
|
36
|
+
### updateAudioInput()
|
|
37
|
+
|
|
38
|
+
```ts
|
|
39
|
+
updateAudioInput(id): void;
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
#### Parameters
|
|
43
|
+
|
|
44
|
+
| Parameter | Type |
|
|
45
|
+
| ------ | ------ |
|
|
46
|
+
| `id` | `string` |
|
|
47
|
+
|
|
48
|
+
#### Returns
|
|
49
|
+
|
|
50
|
+
`void`
|
|
51
|
+
|
|
52
|
+
***
|
|
53
|
+
|
|
54
|
+
### updateVideoInput()
|
|
55
|
+
|
|
56
|
+
```ts
|
|
57
|
+
updateVideoInput(id): void;
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
#### Parameters
|
|
61
|
+
|
|
62
|
+
| Parameter | Type |
|
|
63
|
+
| ------ | ------ |
|
|
64
|
+
| `id` | `string` |
|
|
65
|
+
|
|
66
|
+
#### Returns
|
|
67
|
+
|
|
68
|
+
`void`
|
|
69
|
+
|
|
70
|
+
***
|
|
71
|
+
|
|
72
|
+
### applyChanges()
|
|
73
|
+
|
|
74
|
+
```ts
|
|
75
|
+
applyChanges(force?): Promise<void>;
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
#### Parameters
|
|
79
|
+
|
|
80
|
+
| Parameter | Type |
|
|
81
|
+
| ------ | ------ |
|
|
82
|
+
| `force?` | `boolean` |
|
|
83
|
+
|
|
84
|
+
#### Returns
|
|
85
|
+
|
|
86
|
+
`Promise`\<`void`\>
|
|
87
|
+
|
|
88
|
+
***
|
|
89
|
+
|
|
90
|
+
### revertChanges()
|
|
91
|
+
|
|
92
|
+
```ts
|
|
93
|
+
revertChanges(): Promise<void>;
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
#### Returns
|
|
97
|
+
|
|
98
|
+
`Promise`\<`void`\>
|
|
99
|
+
|
|
100
|
+
***
|
|
101
|
+
|
|
102
|
+
### onMediaChanged()
|
|
103
|
+
|
|
104
|
+
```ts
|
|
105
|
+
onMediaChanged(callback): Unsubscribe;
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
#### Parameters
|
|
109
|
+
|
|
110
|
+
| Parameter | Type |
|
|
111
|
+
| ------ | ------ |
|
|
112
|
+
| `callback` | `EventCallback`\<[`Media`](Media.mdx)\> |
|
|
113
|
+
|
|
114
|
+
#### Returns
|
|
115
|
+
|
|
116
|
+
[`Unsubscribe`](../type-aliases/Unsubscribe.mdx)
|
|
117
|
+
|
|
118
|
+
***
|
|
119
|
+
|
|
120
|
+
### onAudioInputChanged()
|
|
121
|
+
|
|
122
|
+
```ts
|
|
123
|
+
onAudioInputChanged(callback): Unsubscribe;
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
#### Parameters
|
|
127
|
+
|
|
128
|
+
| Parameter | Type |
|
|
129
|
+
| ------ | ------ |
|
|
130
|
+
| `callback` | `EventCallback`\<[`PreviewInput`](../type-aliases/PreviewInput.mdx)\> |
|
|
131
|
+
|
|
132
|
+
#### Returns
|
|
133
|
+
|
|
134
|
+
[`Unsubscribe`](../type-aliases/Unsubscribe.mdx)
|
|
135
|
+
|
|
136
|
+
***
|
|
137
|
+
|
|
138
|
+
### onVideoInputChanged()
|
|
139
|
+
|
|
140
|
+
```ts
|
|
141
|
+
onVideoInputChanged(callback): Unsubscribe;
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
#### Parameters
|
|
145
|
+
|
|
146
|
+
| Parameter | Type |
|
|
147
|
+
| ------ | ------ |
|
|
148
|
+
| `callback` | `EventCallback`\<[`PreviewInput`](../type-aliases/PreviewInput.mdx)\> |
|
|
149
|
+
|
|
150
|
+
#### Returns
|
|
151
|
+
|
|
152
|
+
[`Unsubscribe`](../type-aliases/Unsubscribe.mdx)
|
|
153
|
+
|
|
154
|
+
***
|
|
155
|
+
|
|
156
|
+
### onUpdatingPreviewAudio()
|
|
157
|
+
|
|
158
|
+
```ts
|
|
159
|
+
onUpdatingPreviewAudio(callback): Unsubscribe;
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
#### Parameters
|
|
163
|
+
|
|
164
|
+
| Parameter | Type |
|
|
165
|
+
| ------ | ------ |
|
|
166
|
+
| `callback` | `EventCallback`\<`boolean`\> |
|
|
167
|
+
|
|
168
|
+
#### Returns
|
|
169
|
+
|
|
170
|
+
[`Unsubscribe`](../type-aliases/Unsubscribe.mdx)
|
|
171
|
+
|
|
172
|
+
***
|
|
173
|
+
|
|
174
|
+
### onUpdatingPreviewVideo()
|
|
175
|
+
|
|
176
|
+
```ts
|
|
177
|
+
onUpdatingPreviewVideo(callback): Unsubscribe;
|
|
178
|
+
```
|
|
179
|
+
|
|
180
|
+
#### Parameters
|
|
181
|
+
|
|
182
|
+
| Parameter | Type |
|
|
183
|
+
| ------ | ------ |
|
|
184
|
+
| `callback` | `EventCallback`\<`boolean`\> |
|
|
185
|
+
|
|
186
|
+
#### Returns
|
|
187
|
+
|
|
188
|
+
[`Unsubscribe`](../type-aliases/Unsubscribe.mdx)
|
|
189
|
+
|
|
190
|
+
***
|
|
191
|
+
|
|
192
|
+
### onUpdatingMain()
|
|
193
|
+
|
|
194
|
+
```ts
|
|
195
|
+
onUpdatingMain(callback): Unsubscribe;
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
#### Parameters
|
|
199
|
+
|
|
200
|
+
| Parameter | Type |
|
|
201
|
+
| ------ | ------ |
|
|
202
|
+
| `callback` | `EventCallback`\<`boolean`\> |
|
|
203
|
+
|
|
204
|
+
#### Returns
|
|
205
|
+
|
|
206
|
+
[`Unsubscribe`](../type-aliases/Unsubscribe.mdx)
|
|
207
|
+
|
|
208
|
+
***
|
|
209
|
+
|
|
210
|
+
### onAudioInputError()
|
|
211
|
+
|
|
212
|
+
```ts
|
|
213
|
+
onAudioInputError(callback): Unsubscribe;
|
|
214
|
+
```
|
|
215
|
+
|
|
216
|
+
#### Parameters
|
|
217
|
+
|
|
218
|
+
| Parameter | Type |
|
|
219
|
+
| ------ | ------ |
|
|
220
|
+
| `callback` | `EventErrorCallback` |
|
|
221
|
+
|
|
222
|
+
#### Returns
|
|
223
|
+
|
|
224
|
+
[`Unsubscribe`](../type-aliases/Unsubscribe.mdx)
|
|
225
|
+
|
|
226
|
+
***
|
|
227
|
+
|
|
228
|
+
### onVideoInputError()
|
|
229
|
+
|
|
230
|
+
```ts
|
|
231
|
+
onVideoInputError(callback): Unsubscribe;
|
|
232
|
+
```
|
|
233
|
+
|
|
234
|
+
#### Parameters
|
|
235
|
+
|
|
236
|
+
| Parameter | Type |
|
|
237
|
+
| ------ | ------ |
|
|
238
|
+
| `callback` | `EventErrorCallback` |
|
|
239
|
+
|
|
240
|
+
#### Returns
|
|
241
|
+
|
|
242
|
+
[`Unsubscribe`](../type-aliases/Unsubscribe.mdx)
|
|
243
|
+
|
|
244
|
+
***
|
|
245
|
+
|
|
246
|
+
### onApplyChangesError()
|
|
247
|
+
|
|
248
|
+
```ts
|
|
249
|
+
onApplyChangesError(callback): Unsubscribe;
|
|
250
|
+
```
|
|
251
|
+
|
|
252
|
+
#### Parameters
|
|
253
|
+
|
|
254
|
+
| Parameter | Type |
|
|
255
|
+
| ------ | ------ |
|
|
256
|
+
| `callback` | `EventErrorCallback` |
|
|
257
|
+
|
|
258
|
+
#### Returns
|
|
259
|
+
|
|
260
|
+
[`Unsubscribe`](../type-aliases/Unsubscribe.mdx)
|
|
261
|
+
|
|
262
|
+
***
|
|
263
|
+
|
|
264
|
+
### onRevertChangesError()
|
|
265
|
+
|
|
266
|
+
```ts
|
|
267
|
+
onRevertChangesError(callback): Unsubscribe;
|
|
268
|
+
```
|
|
269
|
+
|
|
270
|
+
#### Parameters
|
|
271
|
+
|
|
272
|
+
| Parameter | Type |
|
|
273
|
+
| ------ | ------ |
|
|
274
|
+
| `callback` | `EventErrorCallback` |
|
|
275
|
+
|
|
276
|
+
#### Returns
|
|
277
|
+
|
|
278
|
+
[`Unsubscribe`](../type-aliases/Unsubscribe.mdx)
|
|
279
|
+
|
|
280
|
+
***
|
|
281
|
+
|
|
282
|
+
### onAudioMuted()
|
|
283
|
+
|
|
284
|
+
```ts
|
|
285
|
+
onAudioMuted(callback): Unsubscribe;
|
|
286
|
+
```
|
|
287
|
+
|
|
288
|
+
#### Parameters
|
|
289
|
+
|
|
290
|
+
| Parameter | Type |
|
|
291
|
+
| ------ | ------ |
|
|
292
|
+
| `callback` | `EventCallback`\<`boolean` \| `undefined`\> |
|
|
293
|
+
|
|
294
|
+
#### Returns
|
|
295
|
+
|
|
296
|
+
[`Unsubscribe`](../type-aliases/Unsubscribe.mdx)
|
|
297
|
+
|
|
298
|
+
***
|
|
299
|
+
|
|
300
|
+
### onAudioSuspended()
|
|
301
|
+
|
|
302
|
+
```ts
|
|
303
|
+
onAudioSuspended(callback): Unsubscribe;
|
|
304
|
+
```
|
|
305
|
+
|
|
306
|
+
#### Parameters
|
|
307
|
+
|
|
308
|
+
| Parameter | Type |
|
|
309
|
+
| ------ | ------ |
|
|
310
|
+
| `callback` | `EventCallback`\<`boolean` \| `undefined`\> |
|
|
311
|
+
|
|
312
|
+
#### Returns
|
|
313
|
+
|
|
314
|
+
[`Unsubscribe`](../type-aliases/Unsubscribe.mdx)
|
|
315
|
+
|
|
316
|
+
***
|
|
317
|
+
|
|
318
|
+
### onVideoMuted()
|
|
319
|
+
|
|
320
|
+
```ts
|
|
321
|
+
onVideoMuted(callback): Unsubscribe;
|
|
322
|
+
```
|
|
323
|
+
|
|
324
|
+
#### Parameters
|
|
325
|
+
|
|
326
|
+
| Parameter | Type |
|
|
327
|
+
| ------ | ------ |
|
|
328
|
+
| `callback` | `EventCallback`\<`boolean` \| `undefined`\> |
|
|
329
|
+
|
|
330
|
+
#### Returns
|
|
331
|
+
|
|
332
|
+
[`Unsubscribe`](../type-aliases/Unsubscribe.mdx)
|
|
333
|
+
|
|
334
|
+
***
|
|
335
|
+
|
|
336
|
+
### onVideoSuspended()
|
|
337
|
+
|
|
338
|
+
```ts
|
|
339
|
+
onVideoSuspended(callback): Unsubscribe;
|
|
340
|
+
```
|
|
341
|
+
|
|
342
|
+
#### Parameters
|
|
343
|
+
|
|
344
|
+
| Parameter | Type |
|
|
345
|
+
| ------ | ------ |
|
|
346
|
+
| `callback` | `EventCallback`\<`boolean` \| `undefined`\> |
|
|
347
|
+
|
|
348
|
+
#### Returns
|
|
349
|
+
|
|
350
|
+
[`Unsubscribe`](../type-aliases/Unsubscribe.mdx)
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
## Properties
|
|
2
|
+
|
|
3
|
+
| Property | Type | Description |
|
|
4
|
+
| ------ | ------ | ------ |
|
|
5
|
+
| <a id="getcurrentdevices"></a> `getCurrentDevices` | () => `IndexedDevices` | - |
|
|
6
|
+
| <a id="getcurrentmedia"></a> `getCurrentMedia` | () => [`Media`](Media.mdx) \| `undefined` | - |
|
|
7
|
+
| <a id="updatemainstream"></a> `updateMainStream` | (`request`) => `Promise`\<`void`\> | - |
|
|
8
|
+
| <a id="mainmediasignal"></a> `mainMediaSignal` | `Signal`\<[`Media`](Media.mdx) \| `undefined`, [`Media`](Media.mdx) \| `undefined`\> | - |
|
|
9
|
+
| <a id="signals"></a> `signals` | [`MediaSignals`](../type-aliases/MediaSignals.mdx) | - |
|
|
10
|
+
| <a id="onended"></a> `onEnded?` | () => `void` | - |
|
|
11
|
+
| <a id="fftsize"></a> `fftSize?` | `number` | - |
|
|
12
|
+
| <a id="queueoptions"></a> `queueOptions?` | `Partial`\<`AsyncQueueOptions`\> | - |
|
|
13
|
+
| <a id="audioprocessors"></a> `audioProcessors` | [`TrackProcessor`](../type-aliases/TrackProcessor.mdx)[] | - |
|
|
14
|
+
| <a id="videoprocessors"></a> `videoProcessors` | [`TrackProcessor`](../type-aliases/TrackProcessor.mdx)[] | - |
|
|
15
|
+
| <a id="getdefaultconstraints"></a> `getDefaultConstraints?` | () => `object` | Pass default constraints to use with get media wrappers |
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
## Properties
|
|
2
|
+
|
|
3
|
+
| Property | Type | Description |
|
|
4
|
+
| ------ | ------ | ------ |
|
|
5
|
+
| <a id="vadthrottlems"></a> `vadThrottleMS?` | `number` | Voice Activity Detection in millisecond |
|
|
6
|
+
| <a id="shoulddetectvoiceactivity"></a> `shouldDetectVoiceActivity` | () => `boolean` | Whether or not to detect voice activity |
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
```ts
|
|
2
|
+
type GetUserMediaProcess = (request) => Promise<Media>;
|
|
3
|
+
```
|
|
4
|
+
|
|
5
|
+
## Parameters
|
|
6
|
+
|
|
7
|
+
| Parameter | Type |
|
|
8
|
+
| ------ | ------ |
|
|
9
|
+
| `request` | \{ `constraints`: `MediaDeviceRequest`; `originalConstraints`: `MediaDeviceRequest`; `permission`: \{ `audio`: `PermissionState`; `video`: `PermissionState`; \}; `currentMedia`: [`Media`](../interfaces/Media.mdx) \| `undefined`; \} |
|
|
10
|
+
| `request.constraints` | `MediaDeviceRequest` |
|
|
11
|
+
| `request.originalConstraints` | `MediaDeviceRequest` |
|
|
12
|
+
| `request.permission` | \{ `audio`: `PermissionState`; `video`: `PermissionState`; \} |
|
|
13
|
+
| `request.permission.audio` | `PermissionState` |
|
|
14
|
+
| `request.permission.video` | `PermissionState` |
|
|
15
|
+
| `request.currentMedia` | [`Media`](../interfaces/Media.mdx) \| `undefined` |
|
|
16
|
+
|
|
17
|
+
## Returns
|
|
18
|
+
|
|
19
|
+
`Promise`\<[`Media`](../interfaces/Media.mdx)\>
|