概述
在服务构建中，我们经常需要对用户的图片做进一步分析。本文利用 智能媒体管理（IMM） 提供的图片索引功能，快速搭建一个图片分类的功能，示例使用 PHP 语言实现。
我们以新闻场景为例。用户上传了若干体育运动相关图片，我们需要按照运动的类别进行分类管理。操作流程如下：
- 将图片传入 OSS 存储中。
- 创建一个媒体集 Set，用于存储这些图片的 元数据。
- 将图片索引至 Set 内。
- 按照标签进行搜索。
如下图：
![ImageClassifyIntro]( "ImageClassifyIntro")
下面我们分步操作一下。
创建 IMM 项目
开通 IMM 服务后，访问 控制台 ，在左侧点击加号创建一个新项目。
左上方地域我们选择 华东1（杭州），右侧的项目名称命名为 ImageClassifyDemo ，所属地域选择 华东1（杭州） ，类型选择 图片标准型 ，QPS 填入 1 ，点击下一步。
截止本文发表时，图片标准型的 1 QPS 是免费的，可以放心测试。参考 计费说明
![ImageClassifyDemo_CreateProject]( "ImageClassifyDemo_CreateProject")
准备测试图片
我们准备了6张测试图片：
oss://imm-user-wmt-cn-hangzhou/image-classify-demo/basketball-00.jpg
oss://imm-user-wmt-cn-hangzhou/image-classify-demo/basketball-01.jpg
oss://imm-user-wmt-cn-hangzhou/image-classify-demo/basketball-02.jpg
oss://imm-user-wmt-cn-hangzhou/image-classify-demo/soccer-00.jpg
oss://imm-user-wmt-cn-hangzhou/image-classify-demo/soccer-01.jpg
oss://imm-user-wmt-cn-hangzhou/image-classify-demo/soccer-02.jpg
您可以将地址改为 http 路径以在浏览器打开查看。如
https://imm-user-wmt-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/image-classify-demo/soccer-02.jpg
您也可以自己准备图片。请将图片上传至 OSS 中，并确保 OSS 的 Bucket 桶和第一步创建的 IMM 项目在同一个地域。
开始使用
下载并安装最新版本 阿里云 PHP SDK 。
复制如下代码，并填入您的 AccessKey 和 AccessSecret 。您可以在 阿里云用户控制台 获取。
若您使用和本文不同的项目名称、地域、图片等，请修改示例代码中的对应部分。
<?php
// 将本文件置入 SDK 的同目录下
include_once './aliyun-php-sdk-core/Config.php';
use imm\Request\V20170906 as Imm;
// 填入您的阿里云 AccessKey 和 AccessSecret
const AccessKey = "";
const AccessSecret = "";
// 填入服务开通地域，这里以杭州区域为例
const Region = "cn-hangzhou";
// 填入创建好的 Project 名称
const Project = "ImageClassifyDemo";
// 填入刚上传好的图片 URL，注意替换为自己的 bucket
const Images = [
"oss://imm-user-wmt-cn-hangzhou/image-classify-demo/basketball-00.jpg",
"oss://imm-user-wmt-cn-hangzhou/image-classify-demo/basketball-01.jpg",
"oss://imm-user-wmt-cn-hangzhou/image-classify-demo/basketball-02.jpg",
"oss://imm-user-wmt-cn-hangzhou/image-classify-demo/soccer-00.jpg",
"oss://imm-user-wmt-cn-hangzhou/image-classify-demo/soccer-01.jpg",
"oss://imm-user-wmt-cn-hangzhou/image-classify-demo/soccer-02.jpg",
];
//初始化客户端
$iClientProfile = DefaultProfile::getProfile(
Region,
AccessKey,
AccessSecret
);
$client = new DefaultAcsClient($iClientProfile);
//创建媒体集 Set
$setId = "image-classify-demo";
$request = new Imm\CreateSetRequest();
$request->setProject(Project);
$request->setSetId($setId);
try {
$response = $client->getAcsResponse($request);
print_r("Create set response:\n");
print_r($response);
} catch (ServerException $e){
print_r("Create set failed:\n");
print_r($e);
}
//将图片添加到媒体集
foreach (Images as $OSSURI) {
//由于我们开通 Project 时选择的是限时免费的 1 CU
//因此在循环时增加 sleep 来避免超过请求频率限制
sleep(1);
$request = new Imm\IndexImageRequest();
$request->setProject(Project);
$request->setSetId($setId);
$request->setImageUri($OSSURI);
$response = $client->getAcsResponse($request);
print_r("Index image $OSSURI response:\n" );
print_r($response);
}
//等待索引完成
sleep(5);
//统计下媒体集内的标签数量
$request = new Imm\ListSetTagsRequest();
$request->setProject(Project);
$request->setSetId($setId);
$response = $client->getAcsResponse($request);
print_r("List tags in set response:\n" );
print_r($response);
//获取所有标签为 打篮球 的图片
$request = new Imm\FindImagesByTagNamesRequest();
$request->setProject(Project);
$request->setSetId($setId);
$request->setTagNames(json_encode(["打篮球"]));
$response = $client->getAcsResponse($request);
print_r("Images with tag \"打篮球\" response:\n" );
foreach ($response->Images as $image) {
// 这里仅把搜索到的图片 URI 输出
print_r($image->ImageUri . "\n");
}
//如果想看到更详细的图片信息，可以直接打印 $response
//print_r($response);
随后运行该文件，即可看到返回结果。
代码解析
该段代码主要分为 4 步操作。
创建媒体集 Set
这一步帮助我们在 IMM 的项目中，新建了一个媒体集 Set 。这个 Set 用于保存我们接下来要索引的图片的 元数据 ，即标签、人脸、OCR 等等信息。
这一步正确的输出如下。我们可以看到成功创建了一个叫做 image-classify-demo 的 Set。
CreateSet API 官方文档
Create set response:
stdClass Object
(
[RequestId] => 6B49F679-9ABF-460B-93F3-1941CD5E29E3
[CreateTime] => 2019-01-16T11:09:23.658Z
[SetName] =>
[ModifyTime] => 2019-01-16T11:09:23.658Z
[SetId] => image-classify-demo
)
将图片索引至媒体集 Set
这一步将我们的图片添加至媒体集。
正确输出如下，仅用一张图片的输出示例。
IndexImage API 官方文档
Index image oss://imm-user-wmt-cn-hangzhou/image-classify-demo/basketball-00.jpg response:
stdClass Object
(
[RequestId] => 79F320DB-1985-45F5-A1F6-FBAB4B1726F2
[CreateTime] => 2019-01-16T11:09:24.706Z
[ModifyTime] => 2019-01-16T11:09:24.706Z
[SetId] => image-classify-demo
[RemarksA] =>
[ImageUri] => oss://imm-user-wmt-cn-hangzhou/image-classify-demo/basketball-00.jpg
[RemarksB] =>
)
至此我们的智能媒体集的元数据已经构建完毕了。后面是如何利用元数据进行查询。
获取媒体集 Set 内的标签列表
这一步可以获取到媒体集 Set 内图片的标签列表，及其计数。
正常返回值如下。我们注意到结果是按标签出现次数降序排序的。出现的最多的标签是“体育运动”，出现了 6 次。
ListSetTags API 官方文档
List tags in set response:
stdClass Object
(
[Tags] => Array
(
[0] => stdClass Object
(
[TagCount] => 6
[TagName] => 体育运动
)
[1] => stdClass Object
(
[TagCount] => 6
[TagName] => 球类
)
[2] => stdClass Object
(
[TagCount] => 3
[TagName] => 打篮球
)
[3] => stdClass Object
(
[TagCount] => 3
[TagName] => 踢足球
)
)
[RequestId] => 6D5294A6-2B77-4C86-8857-EAF8EF57D361
[SetId] => image-classify-demo
)
根据标签筛选图片
最后一步我们筛选所有“打篮球”的图片。
正常返回值如下。正确筛选出了 3 张图片。
FindImagesByTagNames API 官方文档
Images with tag "打篮球" response:
oss://imm-user-wmt-cn-hangzhou/image-classify-demo/basketball-02.jpg
oss://imm-user-wmt-cn-hangzhou/image-classify-demo/basketball-01.jpg
oss://imm-user-wmt-cn-hangzhou/image-classify-demo/basketball-00.jpg
当然 元数据 不止有标签，还有人脸等更多信息。可以取消上述代码最后一行的注释来查看全部结果。
以上就是利用 智能媒体管理（IMM） 快速实现了一个图片分类的 DEMO 。如有任何问题可以联系 服务同学 。
