Java生成藝術二維碼也可以很簡單

  • 2019 年 11 月 14 日
  • 筆記

> 原文點擊: Quick-Media Java生成藝術二維碼也可以很簡單

現在二維碼可以說非常常見了,當然我們見得多的一般是白底黑塊,有的再中間加一個 logo,或者將二維碼嵌在一張特定的背景中(比如微信、支付寶的收款碼);偶爾也可能看到一些酷炫的二維碼,比如非黑白的、漸變色的、非方塊樣式的,或者說是動態的二維碼

那麼問題來了,走位一個 java 開發者而言,有沒有什麼開源庫,可以簡單迅速不燒腦的實現各種炫酷的二維碼呢?

接下來我們將介紹下,如何藉助 https://github.com/liuyueyi/quick-media 項目的 qrcode-plugin 來生成各種酷炫的二維碼

<!– more –>

1. 配置

我們主要使用的quick-media項目其中的一個插件:qrcode-plugin,目前已提供 maven 的引入方式,最新版本為2.1

<repositories>      <repository>          <id>yihui-maven-repo</id>          <url>https://raw.githubusercontent.com/liuyueyi/maven-repository/master/repository</url>      </repository>  </repositories>      <dependency>      <groupid>com.github.hui.media</groupid>      <artifactid>qrcode-plugin</artifactid>      <version>2.2</version>  </dependency>

添加依賴之後,我們就可以愉快的玩耍了

2. 實例演示

接下來我們通過一系列的實例程式碼,來演示如何生成各種酷炫的二維碼

a. 基本二維碼

生成一個最常見的最普通的二維碼,並保存到qr.png文件,一行程式碼即可

String msg = "https://weixin.qq.com/r/FS9waAPEg178rUcL93oH";  // 生成二維碼,並輸出為qr.png圖片  boolean ans = QrCodeGenWrapper.of(msg).asFile("qr.png");

b. 顏色指定

默認的二維碼為白底黑塊,如果我希望生成白底藍塊(探測圖形外青內紅)的二維碼,可以如下使用

String msg = "https://weixin.qq.com/r/FS9waAPEg178rUcL93oH";  boolean ans = QrCodeGenWrapper.of(msg)          .setW(300)          // 定位點(探測圖形)外邊顏色          .setDetectOutColor(Color.CYAN)          // 定位點內部顏色          .setDetectInColor(Color.RED)          // 二維碼著色點          .setDrawPreColor(Color.BLUE)          // 二維碼背景圖          .setDrawBgColor(0xffffffff)          .asFile("/tmp/cqr.png");

c. 帶 logo 二維碼生成

logo 目前支援兩種樣式,一個是圓角 logo,一個是直接原圖不做處理;下面是一個簡單的圓角 logo,並帶上邊框的實例

String msg = "https://weixin.qq.com/r/FS9waAPEg178rUcL93oH";  // 這裡的圖片地址,支援網路圖片,本地相對路勁圖片,本地絕對路徑圖片  String logo = "https://static.oschina.net/uploads/user/283/566591_100.jpeg";  boolean ans = QrCodeGenWrapper.of(msg)          .setLogo(logo)          .setLogoStyle(QrCodeOptions.LogoStyle.ROUND)          .setLogoBgColor(0xfffefefe)          .setLogoBorderBgColor(0xffc7c7c7)          .setLogoBorder(true)          .asFile("/tmp/lqr3.png");

下圖展示了四張帶 logo 的二維碼

  • 原始 logo
  • 直角帶 logo 背景色
  • 圓角帶 logo 背景色
  • 圓角帶 logo 背景,邊框

d. 指定背景圖

背景圖目前支援三種樣式,分別是二維碼全覆蓋在背景圖上,在背景圖的自定區間進行繪製二維碼,生成透明二維碼但使用背景圖進行渲染,下面

// 默認屬於全覆蓋的背景模式,對應下圖中左圖  String msg = "https://weixin.qq.com/r/FS9waAPEg178rUcL93oH";  String bg = "https://ww1.sinaimg.cn/large/8154e929gy1g8vho8x6r0j20b40b43yl.jpg";  boolean ans = QrCodeGenWrapper.of(msg)          .setBgImg(bg)          .setW(500)          .setBgOpacity(0.5f)          .asFile("/tmp/bqr1.png");    // 指定為填充模式,在背景圖的坐標(startX, startY)處繪製二維碼(左上角坐標為0,0; 對應下圖中的中圖  bg = "https://pic.51yuansu.com/pic3/cover/01/07/09/59015a0e53d83_610.jpg";  ans = QrCodeGenWrapper.of(msg)          .setBgImg(bg)          .setBgStyle(QrCodeOptions.BgImgStyle.FILL)          .setBgW(500)          .setBgH(500)          .setBgStartX(130)          .setBgStartY(120)          .setW(260)          .setPadding(0)          .setDrawBgColor(0xfff7f7f7)          .asFile("/tmp/bqr2.png");    // 背景渲染方式,用背景圖來填充二維碼,對應下圖中的右圖  bg = "https://img1.juimg.com/180517/355855-1P51H3520817.jpg";  ans = QrCodeGenWrapper.of(msg)          .setBgImg(bg)          .setBgStyle(QrCodeOptions.BgImgStyle.PENETRATE)          .setBgW(500)          .setBgH(500)          .setW(500)          .asFile("/tmp/bqr3.png");

e. 幾何樣式二維碼生成

默認的二維碼的資訊為黑色小方塊,本插件提供了其他的幾個常見的幾何形式支援,如圓點,三角,鑽石,六邊形,八邊形;通過指定 DrawStyle 參數即可

String msg = "https://weixin.qq.com/r/FS9waAPEg178rUcL93oH";  boolean ans = QrCodeGenWrapper.of(msg)          .setW(400)          // 支援將臨近相同的合併成一個大的圓點          .setDrawEnableScale(true)          .setDrawStyle(QrCodeOptions.DrawStyle.CIRCLE)          .asFile("/tmp/dqr6.png");

f. 圖片填充

如果你有一套完整的素材,那麼可以考慮用這些素材來生成一個更漂亮的二維碼;

比如項目的測試中,給出了兩套輸出,一個愛心,一個集合圖形

String msg = "https://weixin.qq.com/r/FS9waAPEg178rUcL93oH";  int size = 500;  boolean ans = QrCodeGenWrapper.of(msg)          .setW(size)          .setH(size)          .setErrorCorrection(ErrorCorrectionLevel.H)          // 因為素材為png透明圖,我們這裡設置二維碼的背景為透明,輸出更加優雅          .setDrawBgColor(ColorUtil.OPACITY)          .setDetectImg("jihe/PDP.png")          .setDrawStyle(QrCodeOptions.DrawStyle.IMAGE)          .addImg(1, 1, "jihe/a.png")          .addImg(3, 1, "jihe/b.png")          .addImg(1, 3, "jihe/c.png")          .addImg(3, 2, "jihe/e.png")          .addImg(2, 3, "jihe/f.png")          .addImg(2, 2, "jihe/g.png")          .addImg(3, 4, "jihe/h.png")          .setPicType("png")          .asFile("/tmp/imgQr1.png");

使用這種方式,需要稍微注意一下

  • 必須制定 DrawStyle 為圖片模式
  • addImg(row, column, img) 來聲明素材對應的應用場景,這個表示當出現一個 row 行,column 列都有資訊時,用 img 來填充

下面是一個是 quick-media 提供的兩種樣式模板

g. 動態二維碼

接下來介紹一下動態二維碼的生成,和背景圖的使用姿勢基本上完全以往,唯一的區別就是背景圖為 gif 動圖

// 全覆蓋模式,指定二維碼的透明度(如下圖左)  String msg = "https://weixin.qq.com/r/FS9waAPEg178rUcL93oH";  String bg = "https://ww1.sinaimg.cn/large/8154e929gy1g8pq78mcgrg20dw0boaja.gif";  boolean ans = QrCodeGenWrapper.of(msg)          .setW(500)          .setBgImg(bg)          .setBgOpacity(0.6f)          .setPicType("gif")          .asFile("/tmp/gifQr1.gif");      // 填充模式,在背景圖的指定位置上繪製二維碼,屬於常見的一種動圖模式(如下圖中)  bg = "https://ww1.sinaimg.cn/large/8154e929gy1g8qe2iv0evg20xc0irn68.gif";  boolean ans = QrCodeGenWrapper.of(msg)        .setW(400)        .setBgImg(bg)        .setBgStyle(QrCodeOptions.BgImgStyle.FILL)        .setBgStartX(20)        .setBgStartY(137)        .setPicType("gif")        .asFile("/tmp/gifQr2.gif");    // 背景渲染模式,直接用背景圖來填充二維碼資訊,因此可以實現炫酷的二維碼(如下圖右)  bg = "https://ww1.sinaimg.cn/large/8154e929gy1g8w7wj6qvsg20oy0io4dt.gif";  boolean ans = QrCodeGenWrapper.of(msg)        .setBgImg(bg)        .setBgW(500)        .setBgH(500)        .setBgStyle(QrCodeOptions.BgImgStyle.PENETRATE)        .setW(500)        .asFile("/tmp/gifQr3.gif");

h. 綜合

上面的幾種 case,是可以組合使用的,最後給一個綜合的"求關注"動態二維碼的生成實例

String msg = "https://weixin.qq.com/r/FS9waAPEg178rUcL93oH";  // 網路動圖背景  String bg = "https://ww1.sinaimg.cn/large/8154e929gy1g8w9jsxwtdg20pz08zwr8.gif";  // 本地logo  String logo = "logo.jpg";  boolean ans = QrCodeGenWrapper.of(msg)          .setW(500)          .setDrawBgColor(ColorUtil.OPACITY)          .setDrawStyle(QrCodeOptions.DrawStyle.IMAGE)          .setDetectImg("jihe/PDP.png")          .addImg(1, 1, "jihe/a.png")          .addImg(3, 1, "jihe/b.png")          .addImg(1, 3, "jihe/c.png")          .addImg(3, 2, "jihe/e.png")          .addImg(2, 3, "jihe/f.png")          .addImg(2, 2, "jihe/g.png")          .addImg(3, 4, "jihe/h.png")          .setPadding(1)          .setErrorCorrection(ErrorCorrectionLevel.H)          .setLogo(logo)          .setLogoBorder(true)          .setLogoStyle(QrCodeOptions.LogoStyle.ROUND)          .setLogoBgColor(0xfffefefe)          .setLogoBorderBgColor(0xffc7c7c7)          .setBgImg(bg)          .setBgW(1870)          .setBgH(646)          .setBgStyle(QrCodeOptions.BgImgStyle.FILL)          .setBgStartX(690)          .setBgStartY(20)          .setBgOpacity(0.9f)          .setPicType("gif")          .asFile("/tmp/gifQr4.gif");