评论

[开盖即食]小程序Canvas官方新版API实战

Canvas 2D 2.9.0 新版API实战, 请注意:官方目前不支持真机调试!!! 只能预览



最近本人在开发一个新项目的时候,注意到官方在2.9.0开始支持了一个canvas 2D的新API,同时对webGL上支持也有了很大的改进,相信很多人用canvas的组件做一些分享海报,战绩和新闻帖功能。

这里是新的引入方式。
官方文档地址:
https://developers.weixin.qq.com/miniprogram/dev/component/canvas.html

那么新的canvas2D API有啥好处呢?

  • 原本的API微信有做一定的修改,现在全面支持源生H5 JS的写法,迁移H5的老代码变成更加容易,学习成本更低
  • 修复了一些诡异的BUG,例如原本在IOS早期版本写法顺序会导致clip()图片裁切失效等~
  • 性能上的优化和提升,复杂动画上帧数明显

举例写法上的一些改变:

1、设置font的写法:

//原本(传值的写法)
ctx.setFontSize(20);
ctx.fillText('MINA', 100, 100)
ctx.draw()

//现在(和源生H5写法一致,赋值)
ctx.font = "16px";
ctx.fillStyle = 'blue'; //可以直接写颜色,原本的不支持
//不需要 ctx.draw()

2、获取并添加图片写法:

//原本
//使用的是 wx.getImageInfo的方法
wx.getImageInfo({
    src: mainImg,//服务器返回的图片地址
    success: function (res) {
        console.log(res);
        ctx.drawImage(res.path, 0, 0);
        ctx.draw(true);
    },
    fail: function (res) {
        //失败回调
    }
});

//现在
//可以直接img.onload调用
const headerImg = canvas.createImage();
headerImg.src = headImage;//微信请求返回头像
headerImg.onload = () => {
    ctx.save();
    ctx.beginPath()//开始创建一个路径
    ctx.arc(38, 288, 18, 0, 2 * Math.PI, false)//画一个圆形裁剪区域
    ctx.clip()//裁剪
    ctx.drawImage(headerImg,0,0);
    ctx.closePath();
    ctx.restore();
}

3、将canvas生成虚拟地址便于下载(重点):


由于官方文档没有写清楚,误导了挺多人的。这里canvas对象必须通过选择器获取,并获得对应的node节点。

async saveImg() {
    let self = this;
    //这里是重点  新版本的type 2d 获取方法
    const query = wx.createSelectorQuery();
    const canvasObj = await new Promise((resolve, reject) => {
      query.select('#posterCanvas')
        .fields({ node: true, size: true })
        .exec(async (res) => {
          resolve(res[0].node);
        })
    });
    console.log(canvasObj);
    wx.canvasToTempFilePath({
      //fileType: 'jpg',
      //canvasId: 'posterCanvas', //之前的写法
      canvas: canvasObj, //现在的写法
      success: (res) => {
        console.log(res);
        self.setData({ canClose: true });
        //保存图片
        wx.saveImageToPhotosAlbum({
          filePath: res.tempFilePath,
          success: function (data) {
            wx.showToast({
              title: '已保存到相册',
              icon: 'success',
              duration: 2000
            })
            // setTimeout(() => {
            //   self.setData({show: false})
            // }, 6000);
          },
          fail: function (err) {
            console.log(err);
            if (err.errMsg === "saveImageToPhotosAlbum:fail auth deny") {
              console.log("当初用户拒绝,再次发起授权")
            } else {
              util.showToast("请截屏保存分享");
            }
          },
          complete(res) {
            wx.hideLoading();
            console.log(res);
          }
        })
      },
      fail(res) {
        console.log(res);
      }
    }, this)
  },

分享个canvas海报的代码片段:

片段名: PoCf4emw7TgE

片段link:
https://developers.weixin.qq.com/s/PoCf4emw7TgE



总结,相对之前还要看官方文档的canvas自定义API,现在写起来更加的方便,老代码迁移起来得心应手,只要你之前会canvas,那么各种效果和动画,拿来就怼,没什么大问题~

一些奇怪的问题(注意!!!)

  1. canvas 2d 目前(2020年4月3日)还不支持真机调试,会报错!!!
  2. IDE工具 1.02.2003190 直接保存新版本canvas的API图片是打不开的,但是直接用手机保存在相册是没问题的,请更新到1.02.2003250 最新版即可解决~
  3. 一些老款手机用新的API保存图片会有报错问题,如华为NOTE10,请更新系统到能支持的最新,且微信也是,即可解决~
  4. 部分Android设备诡异的闪退和报错

    这种有可能是代码写法的问题,比如:
//缺省写法  会导致部分Android机器 闪退
ctx.font = "bold 16px";
ctx.fillStyle = "#000"

//在canvas 2D的写法中,所以写法必须规范且完整
ctx.font = "normal bold 12px sans-serif";  
ctx.fillStyle = '#707070'; 

所以在canvas 2D 的环境,所以写法必须原始且规范,不能用缺省写法,不然就会有诡异的闪退/报错。
后续:官方在7.0.13的Android版本已修复。
https://developers.weixin.qq.com/community/develop/doc/00088c13e1437890692afd8d85ec00

看完觉得有帮助记得点个赞哦~

你的赞是我继续分享的最大动力!^-^

最后一次编辑于  2020-05-09  
点赞 44
收藏
评论

30 个评论

  • 。
    2020-05-16

    为啥我的canvas.width 和 canvas.height 设置了没有效果呢

    2020-05-16
    赞同 2
    回复 1
    • 游戏人生
      游戏人生
      2020-05-17
      你没有填充背景颜色,可以用ctx.rect和ctx.fillStyle 先填充一个矩形颜色,不然初始化的时候就是透明的了
      2020-05-17
      回复
  • 前半生的余路
    前半生的余路
    2020-09-10

    新版api的 drawImage 好像也不能使用 canvas 节点。

    2020-09-10
    赞同 1
    回复 2
    • 游戏人生
      游戏人生
      2020-09-10
      canvas 节点什么意思? selectQuery获取的canvas对象,可以用啊
      2020-09-10
      回复
    • fyter
      fyter
      2022-01-01
      我的也是,离屏画布,节点画布都不能用到drawImage中,真tm艹蛋。开发工具像WX一样屎。很多函数取消了也不更新文档。
      drawImage能画Image对象,文档里也不说。我目前画Image,后面的参数全都失效,还没搞懂怎么回事。
      2022-01-01
      回复
  • GYP
    GYP
    2023-07-11

    我要到难题了,大佬,可否帮我wxml里的制作的表格内容转到canvas,官方给的video转画布,我照猫画虎,结果运不通

    2023-07-11
    赞同
    回复
  • 这可一点都不酷
    这可一点都不酷
    2022-08-18

    用这个将两个图片合成为一个,怎么操作呢


    2022-08-18
    赞同
    回复
  • Yyyyyyy.
    Yyyyyyy.
    2022-05-13

    为啥我保存下载的图片是全黑的

    2022-05-13
    赞同
    回复 1
    • McWhy
      McWhy
      2022-06-20
      我这里电脑保存的图片显示无法打开,使用预览手机保存可以生成图片
      2022-06-20
      回复
  • 甘い
    甘い
    2021-07-21
    const headerImg = canvas.createImage();
    headerImg.src = "http://192.168.1.188/23w4ww/upload/Sewllewwr/48ww/wlogo/5d3c24452b2b3_s.jpg";
    //微信请求返回头像
    headerImg.onload = () => {
        ctx.save();
        ctx.beginPath()//开始创建一个路径
        ctx.arc(38, 288, 18, 0, 2 * Math.PI, false)//画一个圆形裁剪区域
        ctx.clip()//裁剪
        ctx.drawImage(headerImg,0,0);
        ctx.closePath();
        ctx.restore();
    }
    


    这段代码 我用的路径是 :http://192.168.1.188/23w4ww/upload/Sewllewwr/48ww/wlogo/5d3c24452b2b3_s.jpg

    执行了canvas上并没有任何反应,图片也没有。

    2021-07-21
    赞同
    回复
  • 。。
    。。
    2021-01-12

    为什么不能真机调试?

    2021-01-12
    赞同
    回复
  • 发飙的蜗牛
    发飙的蜗牛
    2020-11-11

    canvas.createImage之后图片太高绘制不成功,遇到过么?

    2020-11-11
    赞同
    回复 4
  • 黄正梦
    黄正梦
    2020-11-02

    https://developers.weixin.qq.com/s/ilHNuymR7IlI

    人多的地方看看,有大佬能帮忙看看这个问题么

    2020-11-02
    赞同
    回复
  • 元创科技
    元创科技
    2020-10-19

    本来以为已经一年多了,这个API应该稳定了,想使用新版的canvas的api的。试用+看社区后,发现坑太多了,不敢用,不敢用,不想用

    2020-10-19
    赞同
    回复 3
    • 黄正梦
      黄正梦
      2020-11-02
      快哭了
      2020-11-02
      回复
    • 林
      2020-12-11
      诉我直言,真的垃圾
      2020-12-11
      1
      回复
    • 刘吉田
      刘吉田
      2023-06-16
      2023年6月份了,需要加载字体只能用新版canvas的api,依旧跟坨屎一样。。。iOS下设定canvas尺寸过大直接不往下执行没有任何报错;drawImage的参数莫名其妙的,android正常iOS下直接白屏。。。
      2023-06-16
      回复

正在加载...

登录 后发表内容