抖音开放平台Logo
开发者文档
控制台
  • API 概览
  • 开放能力
  • 基础
  • 渲染
  • 设备
  • 文件
  • 位置
  • 媒体
  • 图片
  • 音频
  • 录屏
  • 麦克风
  • 相机
  • tt.createCamera
  • Camera
  • Camera.start
  • Camera.pause
  • Camera.resume
  • Camera.setBeautifyParam
  • Camera.destroy
  • 录音
  • 视频
  • 人脸检测
  • 手势识别
  • 网络
  • 游戏转发分享
  • 实时语音
  • 数据缓存
  • 系统
  • 广告
  • 界面
  • 支付
  • Worker
  • Camera.start
    收藏
    我的收藏

    启动摄像头,该方式返回一个 Promise 对象,是个异步方法。

    语法

    Camera.start(face, beautify, option)

    参数说明

    字段
    类型
    必填
    说明
    face
    string
    摄像头方向,取值为 "front" 或者 "back", 默认开启前置摄像头
    beautify
    boolean
    开启摄像头美颜, false 表示不开启
    option
    object
    摄像头可选参数

    option

    可选字段
    取值类型
    说明
    gesture
    bool
    是否开启手势识别能力,需要开启时传入 {gesture:true}

    代码示例

    const camera = tt.createCamera(); camera.start("front", true, { gesture: true }).then((video) => { // option传入gesture:true开启手势识别 console.log(video); // 摄像头返回的视频 video.focus(); });

    Bug & Tip

      Tip:只有开启摄像头美白, 调用接口Camera.setBeautifyParam才能设置美白参数。
      Tip:只有开启摄像头美白, 才能进行人脸检测。
      Tip:对于摄像头开启后模糊,可以对摄像头 start 后返回的视频调用 focus 方法,参考上面代码示例。
      Tip:上面代码示例中,摄像头开启后返回的 video 对象指向的是摄像头的实时数据,内部会实时更新 video 对象指向的数据。
      Tip:开发者工具暂不支持此能力,请用真机扫码调试。