智能媒资托管快速入门-SDK 文档-文档中心-腾讯云

准备工作 
1. 您需要一个 iOS 应用，这个应用可以是您现有的工程，也可以是您新建的一个空的工程。
2. 请确保您的 iOS 应用目标为 iOS 9及以上。
步骤1：安装 SDK
podfile 文件中增加pod "QCloudCOSSMH/Api"，终端执行 pod install
﻿
步骤2：开始使用
导入头文件
#import <QCloudCOSSMHApi.h>
初始化 SMH 服务并实现获取 accessToken 协议
说明：
User 模块不需要 accesstoken，若仅使用 User，可以跳过此步骤。
集成 API 和 User 时，获取 accessToken 的方式。
API 模块接口在发出请求时需要携带 accesstoken，所以需要实现 QCloudSMHAccessTokenProvider 协议，在该协议中获取包含 accesstoken 以及 spaceid 等信息的 QCloudSMHSpaceInfo 对象通过参数 continueBlock 回调给 SDK。
- (void)accessTokenWithRequest:(QCloudSMHBizRequest *)request
                   urlRequest:(NSURLRequest *)urlRequst
                    compelete:(QCloudSMHAuthentationContinueBlock)continueBlock {
                    
        // 首先从您的访问令牌服务器获取包含了访问令牌信息的响应
        QCloudSMHSpaceInfo * spaceInfo = [QCloudSMHSpaceInfo new];
        spaceInfo.accessToken = @""; // 访问令牌 Token
        spaceInfo.expiresIn = @""; // 访问令牌的有效时长，单位为秒
        spaceInfo.libraryId = @""; //
        spaceInfo.spaceId = @"";
        continueBlock(sapceInfo, nil);
}
SDK 提供了一个 QCloudSMHAccessTokenFenceQueue 的脚手架，实现对 accessToken 的缓存与复用。脚手架在密钥过期之后会重新调用该协议的方法来重新获取新的密钥，直到该密钥过期时间大于设备的当前时间。
说明：
建议把初始化过程放在 AppDelegate 或者程序单例中。
使用脚手架您需要实现QCloudAccessTokenFenceQueueDelegate协议。
1. 初始化脚手架。
@property (nonatomic) QCloudSMHAccessTokenFenceQueue *fenceQueue;
﻿
self.fenceQueue = [QCloudSMHAccessTokenFenceQueue new];
self.fenceQueue.delegate = self;
2. 实现QCloudAccessTokenFenceQueueDelegate。
- (void)fenceQueue:(QCloudSMHAccessTokenFenceQueue *)queue
           request:(QCloudSMHBizRequest *)request
requestCreatorWithContinue:(QCloudAccessTokenFenceQueueContinue)continueBlock {
    // 首先从您的访问令牌服务器获取包含了访问令牌信息的响应
    QCloudSMHSpaceInfo * spaceInfo = [QCloudSMHSpaceInfo new];
    spaceInfo.accessToken = @""; // 访问令牌 Token
    spaceInfo.expiresIn = @""; // 访问令牌的有效时长，单位为秒
    spaceInfo.libraryId = @""; //
    spaceInfo.spaceId = @"";
    continueBlock(sapceInfo, nil);
}
﻿
// 在该方法中使用脚手架进行请求sdk内部缓存的accesstoken并使用continueBlock回调给sdk，若
// sdk内缓存的accesstoken过期或没有，则跳转到上面方法中进行请求最新的accesstoken回调给sdk并缓存。
- (void)accessTokenWithRequest:(QCloudSMHBizRequest *)request
                   urlRequest:(NSURLRequest *)urlRequst
                    compelete:(QCloudSMHAuthentationContinueBlock)continueBlock {
    [self.fenceQueue performRequest:request
                         withAction:^(QCloudSMHSpaceInfo *_Nonnull accessToken, NSError *_Nonnull error) {
        if (error) {
            continueBlock(nil, error);
        } else {
            continueBlock(accessToken, nil);
        }
    }];
}
说明：
若仅需要 API 模块，则需要一个可以获取智能媒资托管服务访问令牌的业务服务端接口，访问令牌的相关说明请参见 生成访问令牌。
实现 QCloudSMHAccessTokenProvider 协议，在该协议中获取 accesstoken 并包装成一个 QCloudSMHSpaceInfo 对象通过参数 continueBlock 回调给 SDK。
步骤3：访问 SMH 服务
例如：列出文件列表。
QCloudSMHListContentsRequest *req = [QCloudSMHListContentsRequest new];
// 用户所在空间 ID
req.spaceId = @"spaceId";
// 用户所在 libraryid
req.libraryId = @"libraryId";
﻿
// 目录路径或相簿名，对于多级目录，使用斜杠(/)分隔，例如 foo/bar；对于根目录，该参数留空；
req.dirPath = @"dirpath";
[req setFinishBlock:^(QCloudSMHContentListInfo *_Nullable result, NSError *_Nullable error) {
    // result 文件列表数据
    // error 报错信息
}];
// 发起请求
[[QCloudSMHService defaultSMHService] listContents:req];
说明：
SMH SDK 提供了自定义域名的功能，若业务有自研后台，可以使用如下方式更改访问域名，按需配置。
// 配置发布域名    
[QCloudSMHBaseRequest setBaseRequestHost:@"releasehost" targetType:QCloudECDTargetRelease];
// 配置预发布域名    
[QCloudSMHBaseRequest setBaseRequestHost:@"previewhost" targetType:QCloudECDTargetPreview];
// 配置测试域名
[QCloudSMHBaseRequest setBaseRequestHost:@"testhost" targetType:QCloudECDTargetTest];
// 配置开发域名
[QCloudSMHBaseRequest setBaseRequestHost:@"devhost" targetType:QCloudECDTargetDevelop];
// 设置当前模式 开发、测试、预发布、发布
[QCloudSMHBaseRequest setTargetType:QCloudECDTarget];
通用参数介绍
libraryId：媒体库 ID，必选参数。
spaceId：空间 ID，如果媒体库为单租户模式，则该参数固定为连字符（-）；如果媒体库为多租户模式，则必须指定该参数。
accessToken：访问令牌，必选参数。
说明：
更多概念请参见 基本概念。
查看全部接口文档请参见 全部文档。
快速入门

本页目录：

准备工作

步骤1：安装 SDK

步骤2：开始使用

导入头文件

初始化 SMH 服务并实现获取 accessToken 协议

步骤3：访问 SMH 服务

通用参数介绍
