跳到内容

useDisplayMedia

类别
导出大小
496 B
最近更改
5 天前
相关

响应式 mediaDevices.getDisplayMedia 流媒体。

演示

用法

ts
import { useDisplayMedia } from '@vueuse/core'

const { stream, start } = useDisplayMedia()

// start streaming

start()
ts
const video = document.getElementById('video')

watchEffect(() => {
  // preview on a video element
  video.srcObject = stream.value
})

类型声明

显示类型声明
typescript
export interface UseDisplayMediaOptions extends ConfigurableNavigator {
  /**
   * If the stream is enabled
   * @default false
   */
  enabled?: MaybeRef<boolean>
  /**
   * If the stream video media constraints
   */
  video?: boolean | MediaTrackConstraints | undefined
  /**
   * If the stream audio media constraints
   */
  audio?: boolean | MediaTrackConstraints | undefined
}
/**
 * Reactive `mediaDevices.getDisplayMedia` streaming
 *
 * @see https://vueuse.org.cn/useDisplayMedia
 * @param options
 */
export declare function useDisplayMedia(options?: UseDisplayMediaOptions): {
  isSupported: ComputedRef<boolean>
  stream: ShallowRef<MediaStream | undefined, MediaStream | undefined>
  start: () => Promise<MediaStream | undefined>
  stop: () => void
  enabled:
    | Ref<boolean, boolean>
    | ShallowRef<boolean, boolean>
    | WritableComputedRef<boolean, boolean>
    | ShallowRef<true, true>
    | ShallowRef<false, false>
}
export type UseDisplayMediaReturn = ReturnType<typeof useDisplayMedia>

源码

源码演示文档

贡献者

Anthony Fu
IlyaL
Anthony Fu
Fernando Fernández
Robert Rosman
Jelf
wheat
Abderrahim SOUBAI-ELIDRISI

更新日志

v12.8.0 on 3/5/2025
7432f - feat(types): 弃用 MaybeRefMaybeRefOrGetter,转而使用 Vue 原生类型 (#4636)
v12.5.0 on 1/22/2025
c6c6e - feat: 在未使用 useEventListener 的地方使用它 (#4479)
v12.0.0-beta.1 on 11/21/2024
0a9ed - feat!: 移除 Vue 2 支持,优化包大小并清理代码 (#4349)
v10.10.0 on 5/27/2024
a3c6f - fix: 当屏幕不再共享时停止流 (#3976)

根据 MIT 许可证发布。