评论

[开盖即食]小程序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

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

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

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

15 个评论

  • 。
    05-16

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

    05-16
    赞同 1
    回复 1
    • 圣殿骑士
      圣殿骑士
      05-17
      你没有填充背景颜色,可以用ctx.rect和ctx.fillStyle 先填充一个矩形颜色,不然初始化的时候就是透明的了
      05-17
      回复
  • Amy
    Amy
    05-26

    楼主我想问下,为什么我这个保存图片的时候会报错

    05-26
    赞同
    回复 3
    • 圣殿骑士
      圣殿骑士
      05-26
      初步看,问题是出在 canvas 对象上,如果你用新方法,必须是一个当前获取的对象,和之前老方法中canvas的ID方式不同,你先试下文章中的获取的方法,必须是 await 同步方法,我们先排除法一个个看下
      05-26
      回复
    • Amy
      Amy
      05-26回复圣殿骑士
      我传错对象了,是要把那个node值传到canvas里面就可以了
      05-26
      回复
    • 圣殿骑士
      圣殿骑士
      05-26回复Amy
      嗯,问题解决就好
      05-26
      回复
  • 。
    05-16

    05-16
    赞同
    回复 1
    • 圣殿骑士
      圣殿骑士
      05-17
      你用的是京东的taro,这个第三方的框架,我没用过,不太确定,不过原生的方法节点是  res[0].node,不是res.node
      05-17
      回复
  • 韦不吕🙈🙉🙊
    韦不吕🙈🙉🙊
    05-14

    我遇到的问题:使用canvas 2D,PC开发工具可以绘制canvas,可以保存为图片。手机上预览canvas无法绘制出图片,只有一片区域。

    05-14
    赞同
    回复 4
    • 圣殿骑士
      圣殿骑士
      05-15
      有代码段吗?。。。这个我很难脑补问题啊
      05-15
      回复
    • 韦不吕🙈🙉🙊
      韦不吕🙈🙉🙊
      05-15回复圣殿骑士
      谢谢关注。我是做的页面截图。做了更多测试发现页面比较短就可以绘制,长了就是空白。旧的canvas可以做长截图。新不如旧。看看原厂怎么演进吧。
      05-15
      回复
    • Z_浩南
      Z_浩南
      2天前
      可能是这段代码执行了多次
      2天前
      回复
    • Z_浩南
      Z_浩南
      2天前
      可能是这段代码执行了多次
      2天前
      回复
  • 韦不吕🙈🙉🙊
    韦不吕🙈🙉🙊
    05-12

    请教怎样得到android版本和ios微信当前的字体?

    05-12
    赞同
    回复 1
    • 圣殿骑士
      圣殿骑士
      05-14
      当前字体? 就是IOS默认的字体,这个可以问google下,我记得中文是“苹方字体”,因为几个经典字体都支持。Android 不清楚
      05-14
      回复
  • 一念之间
    一念之间
    05-12

    canvas动画闪退怎么解决啊?

    05-12
    赞同
    回复 1
    • 圣殿骑士
      圣殿骑士
      05-14
      微信更新到最新7.0.13版本,IDE工具更新到最新,再看下,之前一些妖怪BUG基本都解决了
      05-14
      回复
  • 世界尽头
    世界尽头
    05-09

    另外补充一个安卓闪退的情况:

    ctx.font = "normal bold 12px sans-serif";

    这里面的字体如果设置比较特殊的(或者说在手机上没有这个字体,具体不太确定),如 PingFangSC-Regular、PingFang SC,也会在安卓手机闪退。

    05-09
    赞同
    回复 7
    • 圣殿骑士
      圣殿骑士
      05-09
      粗体和闪退 这个问题现在已经修复了,我们公司的小米和华为升级到7.0.13微信 就好了。至于你列出来的那个特殊字体,我没试过,不做评论
      05-09
      回复
    • 圣殿骑士
      圣殿骑士
      05-09
      建议检查下微信版本和基础库
      05-09
      回复
    • 世界尽头
      世界尽头
      05-09回复圣殿骑士
      感谢回复。升级微信到 7.0.13 后,设置特殊的字体确实不会闪退了。但是又有一个奇怪的问题,就是字体大小又不生效了(测试手机:小米 8,系统是 MIUI 11,Android 10)。另外无论怎么设置字体,在真机上字体粗细都不生效。模拟器一切正常。
      我对比了一下我的写法跟您帖子里的写法,唯一的区别就是我的代码中字体大小有个 rpx 转 px,不确定是不是由于转换的结果有小数之类的导致的问题。
      05-09
      回复
    • 世界尽头
      世界尽头
      05-09
      补充一个真机和模拟器对比图。左边真机,右边模拟器。
      ctx.font = 'normal bold 36px sans-serif';
      05-09
      回复
    • 圣殿骑士
      圣殿骑士
      05-09回复世界尽头
      上面数字是加粗的吧?就文字不加粗? 你身边有其他Android机器可以对比测试吗?  公司的小米 9p我测过最新版本是好的,可以加粗
      05-09
      回复
    查看更多(2)
  • 世界尽头
    世界尽头
    05-09

    真机粗体不生效有解决办法吗?模拟器显示正常,但是在真机上目测只有数字生效了。

    05-09
    赞同
    回复 2
  • guo
    guo
    04-28

    OPPO R11,写了个ctx.font = "12px 微软雅黑",闪退了,忘了大佬这篇文章提醒了,已剁手惩戒/(ㄒoㄒ)/~~

    04-28
    赞同
    回复 1
    • 圣殿骑士
      圣殿骑士
      04-28
      没事,找到原因避免就好
      04-28
      回复
  • 在劫难逃的天真
    在劫难逃的天真
    04-21

    剪裁圆形 对png格式的图不生效么?

    04-21
    赞同
    回复 1
    • 圣殿骑士
      圣殿骑士
      04-28
      生效的。是这样的,之前有类似的BUG,但是在最新微信版本已修复
      04-28
      回复

正在加载...

登录 后发表内容