Zoom Apps SDK中使用getUserMedia获取音频流返回undefined的解决方法

云原生阿岚

2026-6-22

在Zoom Apps中获取用户实时音频流的解决方案

由于Zoom Apps运行在受限的沙箱环境中，浏览器原生的getUserMedia接口无法直接访问设备硬件，这是你返回undefined的核心原因。以下是通过Zoom Apps SDK实现需求的具体步骤：

1. 配置应用权限

登录Zoom App Marketplace，进入你的应用配置页面
在Features > Capabilities中，勾选audio权限（属于设备权限范畴）
保存配置并重新发布应用

2. 初始化SDK并请求权限

在应用代码中，先初始化Zoom Apps SDK，并显式请求麦克风权限：

// 初始化SDK
await zoomSdk.init({
  capabilities: ['audio']
});

// 运行时请求麦克风权限
async function requestAudioAccess() {
  const permissionStatus = await zoomSdk.permissions.requestPermission('audio');
  if (permissionStatus !== 'granted') {
    console.error('麦克风权限未授权');
    return;
  }
  // 权限通过后获取音频流
  fetchAudioStream();
}

3. 通过SDK获取音频流

使用Zoom Apps SDK提供的media.getUserMedia接口替代原生方法：

async function fetchAudioStream() {
  try {
    const audioStream = await zoomSdk.media.getUserMedia({
      audio: true,
      video: false
    });
    // 这里可以将audioStream传入你的语音处理逻辑
    const audioCtx = new AudioContext();
    const sourceNode = audioCtx.createMediaStreamSource(audioStream);
    // 后续语音处理操作...
  } catch (err) {
    console.error('获取音频流失败:', err.message);
  }
}