抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • API 概览
  • C# API
  • 开放接口
  • 收藏
  • 群聊
  • 关注
  • 数据分析
  • 基础
  • 渲染
  • 设备
  • 文件
  • 位置
  • 媒体
  • 图片
  • 音频
  • 录屏
  • 麦克风
  • 实时语音
  • 相机
  • tt.createCamera
  • Camera
  • Camera.start
  • Camera.pause
  • Camera.resume
  • Camera.setBeautifyParam
  • Camera.destroy
  • 录音
  • 视频
  • AI
  • 网络
  • 转发
  • 数据缓存
  • 广告
  • 界面
  • 支付
  • Worker
  • Camera.start
    收藏
    我的收藏

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

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

    前提条件
    业务背景
    使用限制
    注意事项
    • 只有开启摄像头美白, 调用接口Camera.setBeautifyParam才能设置美白参数。
    • 只有开启摄像头美白, 才能进行人脸检测。
    • 对于摄像头开启后模糊,可以对摄像头 start 后返回的视频调用 focus 方法,参考代码示例。
    • 上面代码示例中,摄像头开启后返回的 video 对象指向的是摄像头的实时数据,内部会实时更新 video 对象指向的数据。
    • 开发者工具暂不支持美颜和手势识别能力,请用真机扫码调试。
    相关教程

    语法

    Camera.start(face, beautify, option)

    参数说明

    face

    类型默认值必填说明最低支持版本
    string
    摄像头方向,取值为 "front" 或者 "back",默认开启前置摄像头
    1.40.0

    beautify

    类型默认值必填说明最低支持版本
    boolean
    开启摄像头美颜, false 表示不开启
    1.40.0

    option

    类型默认值必填说明最低支持版本
    object
    摄像头可选参数
    1.40.0

    option 类型说明

    object 类型,属性如下:

    属性名类型默认值必填说明最低支持版本
    gestureboolean
    是否开启手势识别能力
    1.40.0

    返回值

    类型说明最低支持版本
    Promise

    Promise对象,resolve 时可获取video 实例

    1.40.0

    代码示例

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