抖音开放平台Logo
控制台

tt.requestMicrophone
收藏
我的收藏

基础库 1.23.0 开始支持本方法，这是一个同步方法。

向端上发出麦克风请求，调起麦克风功能。

前提条件无
业务背景无
使用限制无
注意事项
  • 对于一些声音类游戏，比如声控游戏，需要在录屏分享时带上麦克风声音，请参考 AudioContext.createMediaStreamSource 方法使用
  • 本 API 在游戏整个生命周期过程中，应当只被调用一次，如果需要暂停恢复，请配合 tt.pauseMicroPhone 和 tt.resumeMicrophone 使用
相关教程无

语法

tt.requestMicrophone()

参数说明

无

返回值

类型说明最低支持版本
Promise

Promise<number> 对象，其中数字是一个 stream ID

1.23.0

代码示例

async function main() {
  const streamID = await tt.requestMicrophone();
  const context = tt.getAudioContext();
  const sourceNode = context.createMediaStreamSource(streamID);
  // sourceNode.connect(context.destination);

  /**
   * 检测音量以确认麦克风确实起效了
   */
  const volumeDetectionNode = context.createVolumeDetection();
  sourceNode.connect(volumeDetectionNode);
  volumeDetectionNode.connect(context.destination);

  setInterval(() => {
    const { size, data } = volumeDetectionNode.getVolumeDetectionData();
    const averageVolume =
      data.reduce((prev, volume) => prev + volume, 0) / size;
    console.log(`[API: microphone] average volumn: ${averageVolume}`);
  }, 2000);
}

main();