-
Notifications
You must be signed in to change notification settings - Fork 441
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
feat(media): rank and list device preferences
Signed-off-by: Maksim Sukharev <antreesy.web@gmail.com>
- Loading branch information
Showing
5 changed files
with
264 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,183 @@ | ||
| /** | ||
| * @copyright Copyright (c) 2024 Maksim Sukharev <antreesy.web@gmail.com> | ||
| * | ||
| * @author Maksim Sukharev <antreesy.web@gmail.com> | ||
| * | ||
| * @license AGPL-3.0-or-later | ||
| * | ||
| * This program is free software: you can redistribute it and/or modify | ||
| * it under the terms of the GNU Affero General Public License as | ||
| * published by the Free Software Foundation, either version 3 of the | ||
| * License, or (at your option) any later version. | ||
| * | ||
| * This program is distributed in the hope that it will be useful, | ||
| * but WITHOUT ANY WARRANTY; without even the implied warranty of | ||
| * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | ||
| * GNU Affero General Public License for more details. | ||
| * | ||
| * You should have received a copy of the GNU Affero General Public License | ||
| * along with this program. If not, see <http://www.gnu.org/licenses/>. | ||
| * | ||
| */ | ||
|
|
||
| /** | ||
| * List all registered devices in order of their preferences | ||
| * Show whether device is currently unplugged or selected, if information is available | ||
| * | ||
| * @param devices list of available devices | ||
| * @param audioInputId id of currently selected audio input | ||
| * @param videoInputId id of currently selected video input | ||
| * @param audioInputList list of registered audio devices in order of preference | ||
| * @param videoInputList list of registered video devices in order of preference | ||
| */ | ||
| function listMediaDevices(devices: MediaDeviceInfo[], audioInputId: string, videoInputId: string, audioInputList: MediaDeviceInfo[], videoInputList: MediaDeviceInfo[]) { | ||
| const availableDevices = devices.map(device => device.deviceId).filter(id => id !== 'default') | ||
|
|
||
| const getDeviceString = (device: MediaDeviceInfo, index: number) => { | ||
| const isUnplugged = !availableDevices.includes(device.deviceId) ? ' (unplugged)' : '' | ||
| const isSelected = () => { | ||
| if (device.kind === 'audioinput') { | ||
| return device.deviceId === audioInputId ? ' (selected)' : '' | ||
| } else if (device.kind === 'videoinput') { | ||
| return device.deviceId === videoInputId ? ' (selected)' : '' | ||
| } | ||
| } | ||
| return ` ${index + 1}. ${device.label || device.deviceId}` + isUnplugged + isSelected() | ||
| } | ||
|
|
||
| // eslint-disable-next-line no-console | ||
| console.log(`Media devices: | ||
| Audio input: | ||
| ${audioInputList.map(getDeviceString).join('\n')} | ||
| Video input: | ||
| ${videoInputList.map(getDeviceString).join('\n')} | ||
| `) | ||
| } | ||
|
|
||
| /** | ||
| * Modify devices list. | ||
| * | ||
| * @param device device | ||
| * @param devicesList list of registered devices in order of preference | ||
| * @param promote whether device should be promoted (to be used in updateMediaDevicesPreferences) | ||
| */ | ||
| function registerNewDevice(device: MediaDeviceInfo, devicesList: MediaDeviceInfo[], promote: boolean = false) { | ||
| const newDevicesList = devicesList.slice() | ||
| console.debug('Registering new device:', device) | ||
|
|
||
| if (promote) { | ||
| newDevicesList.unshift(device) | ||
| } else { | ||
| newDevicesList.push(device) | ||
| } | ||
|
|
||
| return newDevicesList | ||
| } | ||
|
|
||
| /** | ||
| * Promote device in the preference list. | ||
| * Regardless if new unknown or registered device was selected, we promote it in the list: | ||
| * - if first item is plugged, then we prefer device out of all options and put it on the first place; | ||
| * - if first item is unplugged, then we don't consider it, and compare with the next in the list; | ||
| * - if second item is unplugged, compare with next in the list; | ||
| * - ... | ||
| * - if N-th item is plugged, then we prefer device to it and put it on the Nth place. | ||
| * | ||
| * Returns changed preference lists for audio / video devices (null, if it hasn't been changed) | ||
| * | ||
| * @param devices list of available devices | ||
| * @param inputList list of registered audio/video devices in order of preference | ||
| * @param inputId id of currently selected input | ||
| */ | ||
| function promoteDevice(devices: MediaDeviceInfo[], inputList: MediaDeviceInfo[], inputId: string | null) { | ||
| const newInputList = inputList.slice() | ||
|
|
||
| // Get the index of the first plugged device | ||
| const availableDevices = devices.map(device => device.deviceId).filter(id => id !== 'default') | ||
| const firstPluggedIndex = newInputList.findIndex(device => availableDevices.includes(device.deviceId)) | ||
| const insertPosition = firstPluggedIndex === -1 ? newInputList.length : firstPluggedIndex | ||
|
|
||
| // Get the index of the currently selected device | ||
| const currentDevicePosition = newInputList.findIndex(device => device.deviceId === inputId) | ||
|
|
||
| if (currentDevicePosition === insertPosition) { | ||
| // preferences list is unchanged | ||
| return null | ||
| } | ||
|
|
||
| let deviceToPromote = null | ||
| if (currentDevicePosition === -1 && inputId !== 'default' && inputId !== null) { | ||
| // If device was not registered in preferences list, get it from devices list | ||
| deviceToPromote = devices.find(device => device.deviceId === inputId) | ||
| } else if (currentDevicePosition > 0) { | ||
| // Otherwise extract it from preferences list | ||
| deviceToPromote = newInputList.splice(currentDevicePosition, 1)[0] | ||
| } | ||
|
|
||
| if (deviceToPromote) { | ||
| // Put the device at the new position | ||
| newInputList.splice(insertPosition, 0, deviceToPromote) | ||
| return newInputList | ||
| } else { | ||
| return null | ||
| } | ||
| } | ||
|
|
||
| /** | ||
| * Populate devices preferences. If device has not yet been registered in preference list, it will be added. | ||
| * | ||
| * Returns changed preference lists for audio / video devices (null, if it hasn't been changed) | ||
| * | ||
| * @param devices list of available devices | ||
| * @param audioInputList list of registered audio devices in order of preference | ||
| * @param videoInputList list of registered video devices in order of preference | ||
| */ | ||
| function populateMediaDevicesPreferences(devices: MediaDeviceInfo[], audioInputList: MediaDeviceInfo[], videoInputList: MediaDeviceInfo[]) { | ||
| let newAudioInputList = null | ||
| let newVideoInputList = null | ||
|
|
||
| for (const device of devices) { | ||
| if (device.kind === 'audioinput') { | ||
| // Add to the list of known devices | ||
| if (device.deviceId !== 'default' && !audioInputList.some(input => input.deviceId === device.deviceId)) { | ||
| newAudioInputList = registerNewDevice(device, audioInputList) | ||
| } | ||
| } else if (device.kind === 'videoinput') { | ||
| // Add to the list of known devices | ||
| if (device.deviceId !== 'default' && !videoInputList.some(input => input.deviceId === device.deviceId)) { | ||
| newVideoInputList = registerNewDevice(device, videoInputList) | ||
| } | ||
| } | ||
| } | ||
|
|
||
| return { | ||
| newAudioInputList, | ||
| newVideoInputList, | ||
| } | ||
| } | ||
|
|
||
| /** | ||
| * Update devices preferences. Assuming that preferred devices were selected, should be called after applying the selection: | ||
| * so either with joining the call or changing device during the call | ||
| * | ||
| * Returns changed preference lists for audio / video devices (null, if it hasn't been changed) | ||
| * | ||
| * @param devices list of available devices | ||
| * @param audioInputId id of currently selected audio input | ||
| * @param videoInputId id of currently selected video input | ||
| * @param audioInputList list of registered audio devices in order of preference | ||
| * @param videoInputList list of registered video devices in order of preference | ||
| */ | ||
| function updateMediaDevicesPreferences(devices: MediaDeviceInfo[], audioInputId: string, videoInputId: string, audioInputList: MediaDeviceInfo[], videoInputList: MediaDeviceInfo[]) { | ||
| return { | ||
| newAudioInputList: promoteDevice(devices, audioInputList, audioInputId), | ||
| newVideoInputList: promoteDevice(devices, videoInputList, videoInputId), | ||
| } | ||
| } | ||
|
|
||
| export { | ||
| listMediaDevices, | ||
| populateMediaDevicesPreferences, | ||
| updateMediaDevicesPreferences, | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters