Skip to content

useDevicesList

类别
导出体积
1.09 kB
上次更改
2 minutes ago
相关

响应式 enumerateDevices 列出可用的输入/输出设备。

示例

相机 (0)
麦克风 (0)
扬声器 (0)

用法

js
import { useDevicesList } from '@vueuse/core'

const {
  devices,
  videoInputs: cameras,
  audioInputs: microphones,
  audioOutputs: speakers,
} = useDevicesList()

组件

vue
<template>
  <UseDevicesList v-slot="{ videoInputs, audioInputs, audioOutputs }">
    摄像头:{{ videoInputs }}
    麦克风:{{ audioInputs }}
    扬声器:{{ audioOutputs }}
  </UseDevicesList>
</template>

类型声明

typescript
export interface UseDevicesListOptions extends ConfigurableNavigator {
  onUpdated?: (devices: MediaDeviceInfo[]) => void
  /**
   * 如果权限未授予,则立即请求权限,否则标签和设备 ID 可能为空
   *
   * @default false
   */
  requestPermissions?: boolean
  /**
   * 请求媒体权限类型
   *
   * @default { audio: true, video: true }
   */
  constraints?: MediaStreamConstraints
}
export interface UseDevicesListReturn {
  /**
   * 所有设备
   */
  devices: Ref<MediaDeviceInfo[]>
  videoInputs: ComputedRef<MediaDeviceInfo[]>
  audioInputs: ComputedRef<MediaDeviceInfo[]>
  audioOutputs: ComputedRef<MediaDeviceInfo[]>
  permissionGranted: Ref<boolean>
  ensurePermissions: () => Promise<boolean>
  isSupported: Ref<boolean>
}
/**
 * 响应式 `enumerateDevices` 列出可用的输入/输出设备
 *
 * @see https://vueuse.org/useDevicesList
 * @param options
 */
export declare function useDevicesList(
  options?: UseDevicesListOptions,
): UseDevicesListReturn

源码

源码演示文档

贡献者

Anthony Fu
一纸忘忧
wheat
Anthony Fu
Félix Zapata
vaakian X
vaakian X
Jelf
Andras Serfozo
Alex Kozack

更新日志

v10.0.0-beta.2 on 3/28/2023
0823d - fix: show devices for Firefox (#2798)
v9.11.0 on 1/17/2023
d5321 - fix(components): mark defineComponent as pure (#2623)