二维码识别_对象存储(OSS)-阿里云帮助中心

二维码识别功能可以识别图片（包括照片、截图等多种图片）中多个有效二维码或者条形码的位置及内容，输出图像中二维码或者条形码的位置框和其包含的文本信息。本文介绍二维码识别的功能参数以及示例。

使用场景

扫码支付：用户可以通过扫描图片中的二维码完成支付。
营销和广告：二维码可以被嵌入到广告宣传海报、产品包装等中，通过扫描二维码用户可以获取更多的产品信息。

注意事项

二维码识别仅支持同步处理（x-oss-process处理方式）。
一张图片多个二维码的情况下，最大可支持的二维码识别数量为5个。
使用二维码识别功能前，需要先绑定IMM Project。关于控制台和API如何绑定，请参见快速入门和AttachOSSBucket。
不支持匿名访问。
必须拥有IMM处理所需的相关权限。更多信息，请参见权限。

参数说明

操作名称：image/codes

说明

具体返回参数，请参看DetectImageCodes - 图片二维码检测。

使用REST API

检测图片中的二维码

处理示例

GET /example.jpg?x-oss-process=image/codes HTTP/1.1
Host: image-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 21 Jul 2023 08:56:50 GMT
Authorization: OSS qn6qrrqxo2oawuk53otf****:UNQDb7GapEgJkcde6OhZ9J****

返回示例

HTTP/1.1 200 OK
Server: AliyunOSS
Date: Fri, 21 Jul 2023 08:56:52 GMT
Content-Type: application/json;charset=utf-8
Content-Length: 64
Connection: keep-alive
x-oss-request-id: 64BA48531253C5383707D5B3
ETag: "2CE2EA370531B7CC1D23BE6015CF5DA5"
Last-Modified: Mon, 10 Jul 2023 13:07:30 GMT
x-oss-object-type: Normal
x-oss-hash-crc64ecma: 13420962247653419692
x-oss-storage-class: Standard
x-oss-ec: 0048-00000104
Content-Disposition: attachment
x-oss-force-download: true
x-oss-server-time: 453

{
  "RequestId" : "3B7BD09F-18D8-56F0-90B7-889FBD9FFF70",
  "Codes": [
    {
      "Content": "https://www.aliyun.com/product/imm",
      "Boundary": {
        "Width": 741,
        "Height": 706,
        "Left": 460,
        "Top": 295,
      }
    }
  ]
}

使用SDK

二维码识别仅支持同步处理，SDK使用方法请参见使用SDK。

常见问题

OSS控制台绑定IMM Project后，使用二维码识别能力报错

原因：未申请新版本IMM数据处理能力相关配额。

解决方案：您需要开启新版本IMM数据处理能力，访问OSS中的图片时需进行签名访问。关于签名的更多信息，请参见签名方式。

登录OSS管理控制台。
在左侧导航栏，选择自助工具 > 更多工具。
在配额中心页签，选择Bucket。
单击开启新版本 IMM Get 数据处理能力右侧的配额申请。
在配额申请对话框，单击确认调整，然后单击确定。