使用C++ SDK實現圖片臉部偵測-Intelligent Media Management-阿里雲

阿里雲API調試工具OpenAPI Explore提供OpenAPI文檔、API調試和SDK樣本，協助您快速入門API開發。本文介紹如何安裝和快速使用Intelligent Media ManagementC++ SDK。

前提條件

已建立並擷取AccessKey。具體操作，請參見建立AccessKey。
已開通OSS服務、建立儲存空間並上傳檔案到儲存空間。具體操作，請參見控制台上傳檔案。
已開通Intelligent Media Management服務。具體操作，請參見開通產品。
已通過Intelligent Media Management控制台建立專案。具體操作，請參見建立專案。
說明
- 您也可以調用API介面建立專案。具體操作，請參見CreateProject - 建立專案。
- 您可以調用ListProjects - 列出所有專案資訊的列表介面列出指定地區下已建立的所有專案資訊。

安裝SDK

重要

調用2020-09-30版本的API，需要使用2020-09-30版本的SDK。

使用Intelligent Media ManagementC++ SDK的操作步驟請參見快速入門。

使用方法

如下以在華東1（杭州）地區中檢測圖片中的人臉及人臉資訊為例介紹如何使用Intelligent Media ManagementC++ SDK。

說明

複製使用如下範例程式碼時請將訪問網域名稱換成您的IMM專案所在Region的網域名稱，並且IMM專案和OSS檔案Region需要保持一致。

#include <cstdlib>
#include <iostream>
#include <string>
#include <alibabacloud/core/AlibabaCloud.h>
#include <imm/ImmClient.h>

using namespace std;
using namespace AlibabaCloud;
using namespace AlibabaCloud::Imm;
    
int main( int argc, char** argv )
{
    AlibabaCloud::InitializeSdk();
    // 填寫專案所在地區ID。
    AlibabaCloud::ClientConfiguration configuration( "cn-hangzhou" );
    // 阿里雲帳號AccessKey擁有所有API的存取權限，建議您使用RAM使用者進行API訪問或日常營運。
    // 強烈建議不要把AccessKey ID和AccessKey Secret儲存到工程代碼裡，否則可能導致AccessKey泄露，威脅您帳號下所有資源的安全。
    // 本樣本通過從環境變數中讀取AccessKey，來實現API訪問的身分識別驗證。如何配置環境變數，請參見https://www.alibabacloud.com/help/document_detail/2361894.html。
    const char *AccessKeyId = std::getenv("AccessKeyId");
    const char *AccessKeySecret = std::getenv("AccessKeySecret");
    AlibabaCloud::Credentials credential( AccessKeyId, AccessKeySecret );

    ImmClient client( credential, configuration );

    Model::DetectImageFacesRequest request;
    // IMM Project名稱。
    request.setProjectName("immtest");
    // 待檢測的圖片OSS URI。
    request.setSourceURI("oss://test-bucket/test-object.jpg");
    //發起請求。
    auto outcome = client.detectImageFaces( request );
    if ( !outcome.isSuccess() )
    {
        std::cout << outcome.error().errorCode() << std::endl;
        AlibabaCloud::ShutdownSdk();
        return(-1);
    }
    
    std::cout << "totalCount: " << outcome.result().getTotalCount() << std::endl;
    
    AlibabaCloud::ShutdownSdk();
    return 0;
}