阿里云API调试工具 OpenAPI Explore 提供OpenAPI文档、API调试和SDK示例,帮助您快速入门API开发。本文介绍如何安装和快速使用智能媒体管理PHP SDK。

前提条件

安装SDK

重要

调用2020-09-30版本的API,需要使用2020-09-30版本的SDK。

使用智能媒体管理PHP SDK的操作步骤请参见 快速入门

使用方法

如下以在华东1(杭州)地域中检测图片中的人脸及人脸信息为例介绍如何使用智能媒体管理PHP SDK。

  1. 创建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());          
  2. 执行 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