抖音开放平台Logo
开发者文档
控制台
  • API 概览
  • 开放能力
  • 基础
  • 渲染
  • 字体
  • 帧率
  • 图片
  • tt.createImage
  • tt.createCanvas
  • Canvas.getContext
  • Canvas.toTempFilePath
  • Canvas.toTempFilePathSync
  • 资源压缩
  • 光标样式
  • 设备
  • 文件
  • 位置
  • 媒体
  • 网络
  • 游戏转发分享
  • 实时语音
  • 数据缓存
  • 系统
  • 广告
  • 界面
  • 支付
  • Worker
  • tt.createCanvas
    收藏
    我的收藏

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

    创建一个画布对象。首次调用创建的是显示在屏幕上的画布,之后调用创建的都是离屏画布。

    前提条件
    业务背景
    使用限制
    注意事项

    如果上屏 Canvas 出现绘制模糊,则需要对上屏 Canvas 进行缩放。举例如下:假如tt.getSystemInfo中返回的screenWidth为360,screenHeight为 640,pixelRatio为 2,你需要主动设置canvas.width = screenWidth * pixelRatio; canvas.height = screenHeight * pixelRatio;才能获得清晰的渲染效果。但这样设置会对渲染速度和内存占用有一些影响。

    相关教程

    语法

    tt.createCanvas()

    参数说明

    返回值

    返回值为 object 类型,详细参数描述如下:

    属性名类型说明最低支持版本
    disposefunction
    主动释放 canvas 的资源,释放后绑定的 context 将无法使用
    1.31.0
    toTempFilePathfunction

    Canvas.toTempFilePath。将当前 Canvas 保存为一个临时文件,并生成相应的临时文件路径,​配置开启开放数据域后,主域所有 canvas 不能调用该接口

    1.31.0
    toTempFilePathSyncfunction

    toTempFilePath 方法的同步版本,参数与 toTempFilePath 的参数 相同,返回值为 string 类型的临时文件路径,配置开启开放数据域后,主域所有 canvas 不能调用该接口

    1.31.0
    widthnumber
    画布的宽度
    1.31.0
    heightnumber
    画布的高度
    1.31.0
    getContextfunction

    Canvas.getContext。获取画布对象的绘图上下文​

    1.31.0
    toDataURLfunction

    把画布上的绘制内容以一个 string 的格式返回,配置开启开放数据域后,主域所有 canvas 不能调用该接口

    1.31.0

    错误码

    errorCodeerrMsgerrorType说明最低支持版本
    999993internal errorF
    小游戏框架内部错误,有需要请创建工单咨询
    1.31.0

    扫码体验

    请使用字节宿主APP扫码

    代码示例