阿里云API调试工具 OpenAPI Explore 提供OpenAPI文档、API调试和SDK示例,帮助您快速入门API开发。本文介绍如何安装和快速使用智能媒体管理PHP SDK。
前提条件
- 已创建并获取AccessKey。具体操作,请参见 创建AccessKey 。
- 已开通OSS服务、创建存储空间并上传文件到存储空间。具体操作,请参见 控制台上传文件 。
- 已开通智能媒体管理服务。具体操作,请参见 开通产品 。
-
已通过智能媒体管理控制台创建项目。具体操作,请参见 创建项目 。
说明-
您也可以调用API接口创建项目。具体操作,请参见 CreateProject - 创建项目 。
-
您可以调用 ListProjects - 列出所有项目信息的列表 接口列出指定地域下已创建的所有项目信息。
-
安装SDK
调用2020-09-30版本的API,需要使用2020-09-30版本的SDK。
使用智能媒体管理PHP SDK的操作步骤请参见 快速入门 。
使用方法
如下以在华东1(杭州)地域中检测图片中的人脸及人脸信息为例介绍如何使用智能媒体管理PHP SDK。
-
创建demo.php文件并写入如下内容。
说明复制使用如下示例代码时请将访问域名换成您的IMM项目所在Region的域名,并且IMM项目和OSS文件Region需要保持一致。
<?php require __DIR__ . '/vendor/autoload.php'; use AlibabaCloud\SDK\Imm\V20200930\Imm; use Darabonba\OpenApi\Models\Config; use AlibabaCloud\SDK\Imm\V20200930\Models\DetectImageFacesRequest; // 阿里云账号AccessKey拥有所有API的访问权限,建议您使用RAM用户进行API访问或日常运维。 // 强烈建议不要把AccessKey ID和AccessKey Secret保存到工程代码里,否则可能导致AccessKey泄露,威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取AccessKey,来实现API访问的身份验证。如何配置环境变量,请参见https://help.aliyun.com/document_detail/2361894.html。 $config = new Config([ 'regionId' => 'cn-hangzhou', // 填写项目所在地域ID。 'accessKeyId' => $_ENV["AccessKeyId"], 'accessKeySecret' => $_ENV["AccessKeySecret"], // 填写项目名称。 $projectName = 'imm-php-sdk-doc-demo'; // 填写图片的OSS URI。 $sourceURI = 'oss://your-bucket-name/your-path/your-image.jpg'; // 初始化IMM客户端。 $immClient = new Imm($config); // 构造检测图片中的人脸及人脸信息请求。 $detectImageFacesRequest = new DetectImageFacesRequest([ 'projectName' => $projectName, 'sourceURI' => $sourceURI, // 发起请求。 $detectImageFacesResp = $immClient->detectImageFaces($detectImageFacesRequest); // 打印结果。 print_r($detectImageFacesResp->body->toMap());
-
执行
php demo.php
命令,控制台输出结果如下。Array [Faces] => Array [0] => Array [Age] => 12 [AgeSD] => 5 [Attractive] => 0.12099999934435 [Beard] => none [BeardConfidence] => 0.99800002574921 [Boundary] => Array [Height] => 87 [Left] => 280 [Top] => 36 [Width] => 70 [Emotion] => none [EmotionConfidence] => 0.99500000476837 [FaceQuality] => 0.8289999961853 [FigureClusterId] => figure-cluster-id-unavailable [FigureConfidence] => 0.9990000128746 [FigureId] => 3acab8ff-48e7-4647-ac57-b48834db7278 [FigureType] => face [Gender] => male [GenderConfidence] => 0.95099997520447 [Glasses] => none [GlassesConfidence] => 1 [Hat] => hat [HatConfidence] => 0.9879999756813 [HeadPose] => Array [Pitch] => -12.309000015259 [Roll] => -11.362000465393 [Yaw] => 3.4430000782013 [Mask] => none [MaskConfidence] => 0.7509999871254 [Mouth] => open [MouthConfidence] => 0.56699997186661 [Sharpness] => 0.8870000243187 [RequestId] => F6D3FE7E-F0D7-0A5B-AE34-7453991DF9F2