华为云用户手册

断点续传上传 当上传大文件时，经常出现因网络不稳定或程序崩溃导致上传失败的情况。失败后再次重新上传不仅浪费资源，而且当网络不稳定时仍然有上传失败的风险。断点续传上传接口能有效地解决此类问题引起的上传失败，其原理是将待上传的文件分成若干个分段分别上传，并实时地将每段上传结果统一记录在checkpoint文件中，仅当所有分段都上传成功时返回上传成功的结果，否则抛出异常提醒用户再次调用接口进行重新上传（重新上传时因为有checkpoint文件记录当前的上传进度，避免重新上传所有分段，从而节省资源提高效率）。 您可以通过uploadFile进行断点续传上传。该接口可设置的参数如下： 参数 作用 OBS iOS SDK对应方法 bucketName 桶名，必选参数。 request.bucketName objectKey 对象名，必选参数。 request.objectKey objectACLPolicy 对象访问策略。 request.objectACLPolicy storageClass 对象存储类型。 request.storageClass metaDataDict 对象元数据。 request.metaDataDict websiteRedirectLocation 网址重定向位置。 request.websiteRedirectLocation encryption 加密方式。 request.encryption enableCheckpoint 是否开启断点续传模式，默认为NO，表示不开启。 request.enableCheckpoint enableMD5Check 是否开启MD5校验，默认为NO，表示不开启。 request.enableMD5Check checkpointFilePath 记录上传进度的文件，只在断点续传模式下有效。当该值为空时，默认与待上传的本地文件同目录。文件名后缀可指定为obsuploadcheckpoint。 request.checkpointFilePath partSize 分段大小，单位字节，取值范围是100KB~5GB，默认为5MB。 request.partSize 以下代码展示了如何使用断点续传上传接口上传文件： static OBSClient *client;NSString *endPoint = @"your-endpoint";// 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量AccessKeyID和SecretAccessKey。// 您可以登录访问管理控制台获取访问密钥AK/SK，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.htmlchar* ak_env = getenv("AccessKeyID");char* sk_env = getenv("SecretAccessKey");NSString *AK = [NSString stringWithUTF8String:ak_env];NSString *SK = [NSString stringWithUTF8String:sk_env]; // 初始化身份验证OBSStaticCredentialProvider *credentialProvider = [[OBSStaticCredentialProvider alloc] initWithAccessKey:AK secretKey:SK]; //初始化服务配置OBSServiceConfiguration *conf = [[OBSServiceConfiguration alloc] initWithURLString:endPoint credentialProvider:credentialProvider]; // 初始化clientclient = [[OBSClient alloc] initWithConfiguration:conf]; // 分段上传的最大并发数client.configuration.maxConcurrentUploadRequestCount = 5;// 分段上传请求的最大连接数client.configuration.uploadSessionConfiguration.HTTPMaximumConnectionsPerHost = 10;NSString *filePath = [[NSBundle mainBundle]pathForResource:@"fileName" ofType:@"Type"];OBSUploadFileRequest *request = [[OBSUploadFileRequest alloc]initWithBucketName:@"bucketname" objectKey:@"objectname" uploadFilePath:filePath];// 分段大小为5MBrequest.partSize = [NSNumber numberWithInteger: 5 * 1024*1024];// 开启断点续传模式request.enableCheckpoint = YES;// 指定checkpoint文件路径request.checkpointFilePath = @"Your CheckPoint File"; // 上传文件request.uploadProgressBlock = ^(int64_t bytesSent, int64_t totalBytesSent, int64_t totalBytesExpectedToSend) { NSLog(@"%0.1f%%",(float)floor(totalBytesSent*10000/totalBytesExpectedToSend)/100);}; OBSBFTask *task = [client uploadFile:request completionHandler:^(OBSUploadFileResponse *response, NSError *error) { NSLog(@"%@",response); if(error){ // 再次上传 }}]; 断点续传上传接口是利用分段上传特性实现的，是对分段上传的封装和加强。 断点续传上传接口不仅能在失败重传时节省资源提高效率，还因其对分段进行并发上传的机制能加快上传速度，帮助用户快速完成上传业务；且其对用户透明，用户不用关心checkpoint文件的创建和删除、分段任务的切分、并发上传的实现等内部细节。 enableCheckpoint参数默认是NO，代表不启用断点续传模式，此时断点续传上传接口退化成对分段上传的简单封装，不会产生checkpoint文件。 checkpointFile参数仅在enableCheckpoint参数为YES时有效。 当前，当有多个上传任务需要并发执行时，需为每个上传任务初始化一个client及request进行处理。 父主题： 上传对象

上传字符串 static OBSClient *client;NSString *endPoint = @"your-endpoint";// 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量AccessKeyID和SecretAccessKey。// 您可以登录访问管理控制台获取访问密钥AK/SK，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.htmlchar* ak_env = getenv("AccessKeyID");char* sk_env = getenv("SecretAccessKey");NSString *AK = [NSString stringWithUTF8String:ak_env];NSString *SK = [NSString stringWithUTF8String:sk_env];// 初始化身份验证OBSStaticCredentialProvider *credentialProvider = [[OBSStaticCredentialProvider alloc] initWithAccessKey:AK secretKey:SK]; //初始化服务配置OBSServiceConfiguration *conf = [[OBSServiceConfiguration alloc] initWithURLString:endPoint credentialProvider:credentialProvider]; // 初始化clientclient = [[OBSClient alloc] initWithConfiguration:conf]; // 流式上传字符串OBSPutObjectWithDataRequest *request = [[OBSPutObjectWithDataRequest alloc]initWithBucketName:@"bucketname" objectKey:@"objectname" uploadData:[@"hello" dataUsingEncoding:NSUTF8StringEncoding]]; // 上传文件进度request.uploadProgressBlock = ^(int64_t bytesSent, int64_t totalBytesSent, int64_t totalBytesExpectedToSend) { NSLog(@"%0.1f%%",(float)floor(totalBytesSent*10000/totalBytesExpectedToSend)/100);}; [client putObject:request completionHandler:^(OBSPutObjectResponse *response, NSError *error){ NSLog(@"%@",response);}];

上传网络流 static OBSClient *client;NSString *endPoint = @"your-endpoint";// 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量AccessKeyID和SecretAccessKey。// 您可以登录访问管理控制台获取访问密钥AK/SK，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.htmlchar* ak_env = getenv("AccessKeyID");char* sk_env = getenv("SecretAccessKey");NSString *AK = [NSString stringWithUTF8String:ak_env];NSString *SK = [NSString stringWithUTF8String:sk_env];// 初始化身份验证OBSStaticCredentialProvider *credentialProvider = [[OBSStaticCredentialProvider alloc] initWithAccessKey:AK secretKey:SK]; //初始化服务配置OBSServiceConfiguration *conf = [[OBSServiceConfiguration alloc] initWithURLString:endPoint credentialProvider:credentialProvider]; // 初始化clientclient = [[OBSClient alloc] initWithConfiguration:conf]; // 流式上传网络流OBSPutObjectWithDataRequest *request = [[OBSPutObjectWithDataRequest alloc] initWithBucketName:@"bucketname" objectKey:@"objectname" uploadDataURL:[NSURL URLWithString:@"DateURL"]]; // 上传文件进度request.uploadProgressBlock = ^(int64_t bytesSent, int64_t totalBytesSent, int64_t totalBytesExpectedToSend) { NSLog(@"%0.1f%%",(float)floor(totalBytesSent*10000/totalBytesExpectedToSend)/100);}; [client putObject:request completionHandler:^(OBSPutObjectResponse *response, NSError *error){ NSLog(@"%@",response);}];

上传文件流 static OBSClient *client;NSString *endPoint = @"your-endpoint";// 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量AccessKeyID和SecretAccessKey。// 您可以登录访问管理控制台获取访问密钥AK/SK，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.htmlchar* ak_env = getenv("AccessKeyID");char* sk_env = getenv("SecretAccessKey");NSString *AK = [NSString stringWithUTF8String:ak_env];NSString *SK = [NSString stringWithUTF8String:sk_env];// 初始化身份验证OBSStaticCredentialProvider *credentialProvider = [[OBSStaticCredentialProvider alloc] initWithAccessKey:AK secretKey:SK]; //初始化服务配置OBSServiceConfiguration *conf = [[OBSServiceConfiguration alloc] initWithURLString:endPoint credentialProvider:credentialProvider]; // 初始化clientclient = [[OBSClient alloc] initWithConfiguration:conf]; NSString *filePath = [[NSBundle mainBundle]pathForResource:@"fileName" ofType:@"Type"];// 文件流上传NSData *uploadData = [NSData dataWithContentsOfFile:filePath];OBSPutObjectWithDataRequest *request = [[OBSPutObjectWithDataRequest alloc]initWithBucketName:@"bucketname" objectKey:@"test/image1" uploadData:uploadData]; // 上传文件进度request.uploadProgressBlock = ^(int64_t bytesSent, int64_t totalBytesSent, int64_t totalBytesExpectedToSend) { NSLog(@"%0.1f%%",(float)floor(totalBytesSent*10000/totalBytesExpectedToSend)/100);}; [client putObject:request completionHandler:^(OBSPutObjectResponse *response, NSError *error){ NSLog(@"%@",response);}]; 推荐使用文件上传的形式上传本地文件，而不是文件流形式。 大文件上传建议使用分段上传。 上传的内容大小不能超过5GB。

SDK公共响应头 调用OBSClient类的相关接口成功后，均会返回公共响应头类，即OBSBaseResponse类实例（或其子类实例），该类包含了HTTP/HTTPS的响应头信息。 处理公共响应头的示例代码如下： static OBSClient *client;NSString *endPoint = @"your-endpoint";// 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量AccessKeyID和SecretAccessKey。// 您可以登录访问管理控制台获取访问密钥AK/SK，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.htmlchar* ak_env = getenv("AccessKeyID");char* sk_env = getenv("SecretAccessKey");NSString *AK = [NSString stringWithUTF8String:ak_env];NSString *SK = [NSString stringWithUTF8String:sk_env]; // 初始化身份验证OBSStaticCredentialProvider *credentialProvider = [[OBSStaticCredentialProvider alloc] initWithAccessKey:AK secretKey:SK]; //初始化服务配置OBSServiceConfiguration *conf = [[OBSServiceConfiguration alloc] initWithURLString:endPoint credentialProvider:credentialProvider]; // 初始化clientclient = [[OBSClient alloc] initWithConfiguration:conf]; // 创建一个请求OBSListBucketsRequest *request = [OBSListBucketsRequest new]; [client listBuckets:request completionHandler:^(OBSListBucketsResponse *response, NSError *error) { NSLog(@"%@",response.headers);}]; 父主题： 异常处理

上传对象 以下代码展示如何上传对象至OBS： NSString *filePath = [[NSBundle mainBundle]pathForResource:@"fileName" ofType:@"Type"];OBSPutObjectWithFileRequest *request = [[OBSPutObjectWithFileRequest alloc]initWithBucketName:@"bucketname" objectKey:@"objectname" uploadFilePath:filePath];// 上传进度request.uploadProgressBlock = ^(int64_t bytesSent, int64_t totalBytesSent, int64_t totalBytesExpectedToSend) { NSLog(@"%0.1f%%",(float)floor(totalBytesSent*10000/totalBytesExpectedToSend)/100);};// 上传文件[ client putObject:request completionHandler:^(OBSPutObjectResponse *response, NSError *error){ NSLog(@"%@",response.etag);}]; 更多上传对象的信息，请参见上传对象。 父主题： 快速入门

添加 域名 您需要将自有的已备案的推流域名、播放域名分别添加到 视频直播 服务中。下面以添加推流域名为例，播放域名的添加步骤与此相同。 登录视频直播控制台。 在左侧导航栏中，选择“域名管理”，进入域名管理页面。 单击“添加域名”。在弹出的“添加域名”页面输入已申请的推流域名。 注意：若您的域名未备案，将添加失败，并提示“添加域名失败：ICP编号不存在”。 表1 域名参数说明 参数名 描述 域名 输入二级推流域名或播放域名。示例：“test-push.example.com”。 说明： 域名长度限制为64个字符，暂不支持大写的域名。 推流域名与播放域名不能相同，不支持添加泛域名。 默认每个账号下最多可创建64个域名。如需增加域名，请提交工单处理。 企业项目 将域名加入到企业项目中统一管理。 在企业项目页面创建企业项目，默认为default企业项目，然后将用户组添加到该企业项目。这时用户组内用户将获得用户组授权的该企业项目下的域名的相关操作权限。 说明： 仅企业账号能够配置企业项目。 域名类型 若“域名”中输入的是推流域名则选择推流域名，否则，选择播放域名。域名类型配置后不可更改。 子服务类型 直播服务的子服务类型。 包括如下选项： 云直播：流式直播服务，提供灵活易用，功能丰富的直播加速能力，适用娱乐、电商、教育等场景。 媒体直播：广播级直播服务，支持频道管理、内容加密等特性，适用于媒资，广电等场景。 请选择“云直播”。 直播源站 直播源站所在地域，可参考如何选择直播源站和加速区域？选择。直播源站配置后不可更改，建议您选择业务就近的源站。 目前支持如下区域： 中国站北京四入口，支持区域：华北-北京四、亚太-新加坡。 国际站新加坡入口，支持区域：亚太-新加坡、拉美-圣保罗一、华北-北京四。 欧洲站都柏林入口，支持区域：欧洲-都柏林。 说明： 推流域名的源站必须选择主播所在区域，不支持主播跨区域推流。比如主播需要同时在中国大陆和马来西亚直播，则需要创建两套推拉流域名，直播源站分别为中国大陆和新加坡。 需要关联的推流域名与播放域名的源站所在区域要保持一致。 用于存储直播录制、截图等的OBS桶必须与直播源站在同一区域，当您的存储已经在某个区域时，对应的直播源站必须选择为相同区域（region）。 加速区域 播放域名可执行加速的地域，可参考如何选择直播源站和加速区域？选择。仅对播放域名有效，推流域名不支持设置。设置完成后，不支持修改。 如果在所选加速区域之外播放，将无法保证功能和质量，请您根据实际业务，选择有效的加速区域。 包含如下选项： 中国大陆 当观众在中国大陆时，应选择此项。 域名需要在工信部备案，推荐您在华为云备案中心备案。 中国大陆境外 当观众在海外、中国香港、中国澳门、中国台湾时，应选择此项。 全球加速 当观众在中国大陆、中国香港、中国澳门、中国台湾或其他国家和地区时，应选择此项。 域名需要在工信部备案，推荐您在华为云备案中心备案。 须知： 如果您选择的加速区域存在跨境场景，您应自行对您的数据跨境行为负责，详见服务声明“2.3 对您的内容数据处理”章节。 支持协议 播放域名支持的播放协议。 仅对播放域名有效，推流域名不支持设置。 设置完成后，不支持修改，默认为“FLV+RTMP+RTC”。 包含如下选项： FLV+RTMP+RTC：播放域名可使用HTTP-FLV、RTMP和WebRTC播放协议，播放云直播内容。 HLS：播放域名可使用HLS播放协议，播放云直播内容。 单击“确定”。 在“域名管理”页面的列表中会新增一条“状态”为“配置中”的域名记录。大概3-5分钟时间，当“状态”为“正常”时，域名添加成功。 执行步骤1-步骤4，完成对播放域名的添加。 播放域名添加后，需要关联添加的推流域名才可使用直播服务。关联的推流域名必须与播放域名归属同一个直播源站，具体请参见关联域名。

操作步骤 下面以播放域名为例，推流域名的CNAME配置步骤相同。 获取域名对应的CNAME值。 登录视频直播控制台。 在左侧导航树中，选择“域名管理 ”。 在所需域名行，获取对应的CNAME。 图1 获取CNAME值 登录云解析服务控制台。 在左侧导航树中，选择“公网域名”。 在需要配置解析的域名行，单击域名名称，如图2所示。 图2 域名列表 单击页面右上角的“添加记录集”。 图3 添加记录集 根据界面提示填写参数配置，参数信息如表1所示。 表1 参数说明 参数名 描述 记录类型 记录集的类型，此处为CNAME类型。 选择“CNAME-将域名指向另外一个域名”。 主机记录 输入域名的二级域名（后缀无需用户手动填写）。 以播放域名“play-test.example.com”为例，此处输入“play-test”。 线路类型 用于DNS服务器在解析域名时，根据访问者的来源，返回对应的服务器IP地址，具体请参见解析线路。 仅支持为公网域名的记录集配置此参数。 选择“全网默认”。 TTL (秒) 解析记录在本地DNS服务器的缓存时间，以秒为单位。 数值越小，修改记录各地生效时间越快。 默认为300秒，若无特殊需求，可直接保持默认选择。 记录值 需指向的域名，即当前章节步骤1中获取的CNAME。 以播放域名“play-test.example.com”为例，此处输入“play-test.example.com.c.cdnhwc3.com”。 别名 用于是否将此记录集关联至云服务资源实例。 开启：为此记录集关联云服务资源实例，详细说明请参见设置记录集别名。 关闭：不为此记录集关联云服务资源实例。 设置为关闭。 权重 可选参数，返回解析记录的权重比例。默认值为1，取值范围：0~1000。 仅支持为公网域名的记录集配置此参数。 当域名在同一解析线路中有多条相同类型的解析记录时，可以通过“权重”设置解析记录的响应比例。详细内容请参见配置权重解析。 配置为“1”。 标签 可选参数，记录集的标识，包括键和值，每个记录集可以创建10个标签。键和值的命名规则，详见添加CNAME类型记录集。 取值示例如下： example_key1 example_value1 描述 可选参数，对域名的描述，主要起到提示作用。 长度不超过255个字符。 单击“确定”，完成添加。 您可以在域名对应的记录集列表中查看添加的记录集。当记录集的状态显示为“正常”时，表示记录集添加成功。 执行步骤1-步骤6，完成对推流域名的CNAME配置。

操作步骤 登录视频直播控制台。 在左侧导航栏中，选择“域名管理”，进入域名管理页面。 单击“添加域名”。在界面右侧弹出的“添加域名”页面输入已申请的播放或推流域名。 注意：若您的域名未备案，将添加失败，并提示“添加域名失败：ICP编号不存在”。 图2 添加域名 表1 域名参数说明 参数名 描述 域名 输入二级推流域名或播放域名。示例：“test-push.example.com”。 说明： 域名长度限制为64个字符，暂不支持大写的域名。 推流域名与播放域名不能相同，不支持添加泛域名。 默认每个账号下最多可创建64个域名。如需增加域名，请提交工单处理。 企业项目 将域名加入到企业项目中统一管理。 在企业项目页面创建企业项目，默认为default企业项目，然后将用户组添加到该企业项目。这时用户组内用户将获得用户组授权的该企业项目下的域名的相关操作权限。 说明： 仅企业账号能够配置企业项目。 域名类型 若“域名”中输入的是推流域名则选择推流域名，否则，选择播放域名。域名类型配置后不可更改。 子服务类型 直播服务的子服务类型。 包括如下选项： 云直播：流式直播服务，提供灵活易用，功能丰富的直播加速能力，适用娱乐、电商、教育等场景。 媒体直播：广播级直播服务，支持频道管理、内容加密等特性，适用于媒资，广电等场景。 请选择“云直播”。 直播源站 直播源站所在地域，可参考如何选择直播源站和加速区域？选择。直播源站配置后不可更改，建议您选择业务就近的源站。 目前支持如下区域： 中国站北京四入口，支持区域：华北-北京四、亚太-新加坡。 国际站新加坡入口，支持区域：亚太-新加坡、拉美-圣保罗一、华北-北京四。 欧洲站都柏林入口，支持区域：欧洲-都柏林。 说明： 推流域名的源站必须选择主播所在区域，不支持主播跨区域推流。比如主播需要同时在中国大陆和马来西亚直播，则需要创建两套推拉流域名，直播源站分别为中国大陆和新加坡。 需要关联的推流域名与播放域名的源站所在区域要保持一致。 用于存储直播录制、截图等的OBS桶必须与直播源站在同一区域，当您的存储已经在某个区域时，对应的直播源站必须选择为相同区域（region）。 加速区域 播放域名可执行加速的地域，可参考如何选择直播源站和加速区域？选择。仅对播放域名有效，推流域名不支持设置。设置完成后，不支持修改。 如果在所选加速区域之外播放，将无法保证功能和质量，请您根据实际业务，选择有效的加速区域。 包含如下选项： 中国大陆 当观众在中国大陆时，应选择此项。 域名需要在工信部备案，推荐您在华为云备案中心备案。 中国大陆境外 当观众在海外、中国香港、中国澳门、中国台湾时，应选择此项。 全球加速 当观众在中国大陆、中国香港、中国澳门、中国台湾或其他国家和地区时，应选择此项。 域名需要在工信部备案，推荐您在华为云备案中心备案。 须知： 如果您选择的加速区域存在跨境场景，您应自行对您的数据跨境行为负责，详见服务声明“2.3 对您的内容数据处理”章节。 支持协议 播放域名支持的播放协议。 仅对播放域名有效，推流域名不支持设置。 设置完成后，不支持修改，默认为“FLV+RTMP+RTC”。 包含如下选项： FLV+RTMP+RTC：播放域名可使用HTTP-FLV、RTMP和WebRTC播放协议，播放云直播内容。 HLS：播放域名可使用HLS播放协议，播放云直播内容。 单击“确定”。 在“域名管理”页面的列表中会新增一条“状态”为“配置中”的域名记录。大概3-5分钟时间，当“状态”为“正常”时，域名添加成功。 播放域名添加后，需要关联推流域名才可使用直播服务。关联的推流域名必须与播放域名归属同一个直播源站，详情请参见关联域名。 域名添加完成后，您需要在播放域名和推流域名的DNS服务商处配置CNAME，将您的域名指向CDN配置的CNAME地址。具体操作请见配置CNAME，配置完成后，对应的域名会自动启用直播加速服务。

前提条件 已添加推流域名和播放域名，且已完成域名关联。 已在域名DNS服务商处完成CNAME解析配置。 为保障直播资源不被非法盗播， 华为云直播 服务提供防盗链功能，对播放地址进行加密鉴权。若有需要，请先配置Key防盗链，然后使用鉴权地址进行播放。加密鉴权方法请参见Key防盗链。 直播服务支持将推送的直播流转码成多种分辨率和码率规格的视频流，以满足不同网络环境的播放需求。若有需要，请在对应推流域名中配置转码模板，然后使用转码播放地址进行播放。

原始播放地址 拼接规则 标准直播场景： 目前播放地址支持FLV、M3U8、RTMP三种格式，对应的拼接规则如下所示： RTMP格式：rtmp://播放域名/AppName/StreamNameFLV格式：http://播放域名/AppName/StreamName.flvM3U8格式：http://播放域名/AppName/StreamName.m3u8 低时延直播场景： 目前播放地址仅支持WebRTC格式，对应的拼接规则如下所示： webrtc://播放域名/AppName/StreamName 拼接示例中的参数说明，如下所示： 播放域名：在视频直播控制台添加的播放域名。 AppName：应用名，默认为“live”，您也可以根据实际需求进行自定义，支持大小写字母、数字、下划线（_）中划线（-）。 StreamName：直播流名，每个应用可创建多个直播流，您可以根据实际需求进行自定义，不支持中文字符。 拼接示例： 标准直播场景： 若添加的播放域名为“test-play.example.com”，“AppName”为“livetest”，“StreamName”为“huawei1”，则不同规格拼接成如下所示的不同的原始播放地址。 RTMP格式：rtmp://test-play.example.com/livetest/huawei1FLV格式：http://test-play.example.com/livetest/huawei1.flvM3U8格式：http://test-play.example.com/livetest/huawei1.m3u8

操作步骤 登录视频直播控制台。 在左侧导航栏中，选择“域名管理”，进入域名管理页面。 在添加的播放域名行右侧单击“管理”，进入基本信息页面，即可查看播放信息。 图1 查看播放地址 您需要根据实际情况自定义“StreamName”，生成对应的原始播放地址，具体请参见原始播放地址。 如果使用原始地址进行直播播放，配置了Key防盗链后，原始播放地址需参见Key防盗链生成鉴权播放地址。 如果使用转码后的地址进行直播播放，需要在原始播放地址中的“StreamName”后加上“_转码模板ID”，重新生成新的“StreamName”，再参见Key防盗链生成新的鉴权参数，最终拼接成转码流的播放地址。

入门指引 若您需要用自己的域名体验完整的云直播功能，可以参考本节快速实现，具体的操作流程，如图1所示。 图1 云直播入门流程 云直播入门操作流程说明，如表1所示。 表1 云直播入门流程说明 序号 操作方法 操作说明 1 添加直播域名 将准备的已备案的域名添加到视频直播服务，包括推流域名和播放域名。您可以注册备案一个一级域名（如example.com），然后使用两个不同的二级域名（如live-play.example.com和live-push.example.com）作为直播推流域名和播放域名。 2 关联域名 推流域名和播放域名添加完成后，您需要在播放域名中关联对应的推流域名，否则将会导致播放失败。 3 配置CNAME 推流域名和播放域名添加成功后，视频直播会为其分配对应的CNAME地址。您需要在域名DNS服务商处为推流域名和播放域名配置CNAME解析，开启直播推流加速和播放加速。 4 开启HTTPS安全加速 您可以为低时延直播开启HTTPS安全加速，保障您的直播数据在传输过程中受到加密保护。 仅低时延直播场景，需要执行此操作。 4 配置推流（可选） 配置转码模板 配置录制模板 配置截图模板 配置推流鉴权 配置播流（可选） 配置延时 配置拉流回源 配置HTTPS 配置播放鉴权 若您需要对直播进行录制、转码、截图、鉴权等操作，您可以在直播开始前，进行相关的配置。 5 推流 您可以使用第三方推流工具OBS进行推流。 标准直播场景，请参考推流操作。 低时延直播场景，请参考推流操作。 6 播放 标准直播场景：您可以使用第三方播放工具VLC进行播放。操作请参考播放。 低时延直播场景：您可以使用华为云低时延在线Demo或根据API接口开放web端播放。操作请参考播放（Web接入方式）。 父主题： 快速入门

回调示例 录制文件生成事件回调示例如下。回调消息体字段如表2所示。 { "project_id": "70b76xxxxxx34253880af501cdxxxxxx", "job_id": "dc0a1773-0cef-xxxx-xxxx-9a38fdb095d2", "task_id": "51126d0ebe94b1da00d2e21a10xxxxxx", "event_type": "RECORD_FILE_COMPLETE", "publish_domain": "push.example.com", "app": "live", "stream": "mystream", "record_format": "HLS", "download_url": "https://obs.cn-north-4.myhuaweicloud.com/live/record-xxxx-mystream-1589967495/record-push.example.com-live-mystream-1589967495.m3u8", "asset_id": "1a0d8e9bfaexxxxxxbe5021e62aa1e96", "file_size": 3957964, "record_duration": 120, "start_time": "2020-03-08T14:10:25Z", "end_time": "2020-03-08T14:12:25Z", "width": 1280, "height": 720, "obs_location": "https://obs.cn-north-4.myhuaweicloud.com", "obs_bucket": "mybucket", "obs_object": "live/record-xxxx-mystream-1589967495/record-hwpublish.myun.tv-live-mystream-1589967495.m3u8", "auth_sign": "4f97f46759axxxxxx7ad21e9935dc175", "auth_timestamp": 1583676745}

注意事项 目前暂只支持直播协议为RTMP和HTTP-FLV，且AppName为live的播放配置延时，若其它App需修改延时配置请提交工单申请。 推流端GOP值不能大于配置的延时，播放的实际延时受播放端的网络情况等因素影响。 播放延时修改后，需重新推流才可生效。 直播延时时间配置过短（2s），会影响HLS视频的播放体验，如：秒开。为避免不好的体验，请配置较长的延时时间（4s或6s）。 低时延直播场景下，不建议使用此功能。

RSA私钥格式要求 PEM格式的文件可以存放证书或私钥，如果*.PEM只包含私钥，一般用*.KEY代替。 通过记事本打开*.PEM或*.KEY的私钥文件，可以查看到类似图3所示的全部私钥信息。 RSA格式私钥： 以证书链“-----BEGIN RSA PRIVATE KEY-----”开头，以证书链“-----END RSA PRIVATE KEY-----”结尾。 证书链之间的内容，要求每行64个字符，最后一行允许不足64个字符。 证书内容不包含空格。

背景信息 强制跳转HTTPS：配置HTTPS后，开启强制跳转HTTPS，若用户发起HTTP请求，服务端会返回302重定向响应，原来的HTTP请求将会被强制重定向为HTTPS请求。 相比HTTP协议，HTTPS具有如下优势： HTTPS协议是由SSL+HTTP协议构建的可进行加密传输、身份认证的网络协议，要比HTTP协议安全，可防止数据在传输过程中被窃取、改变，确保数据的完整性。 在HTTPS协议中，会对用户的关键信息进行加密，避免Session ID或Cookie内容被攻击者捕获，导致敏感信息泄露。

格式转换 配置HTTPS仅支持PEM格式的证书/私钥，其他格式均不支持。其他格式的证书/私钥需要转换成PEM格式，建议通过OpenSSL工具进行转换。下面是几种比较流行的证书格式转换为PEM格式的方法。 以下示例均假设转换前证书名为old_certificate，私钥名为old_key，转换后证书名为new_certificate，私钥文件名为new_key。 DER转换为PEM openssl x509 -inform der -in old_certificate.cer -out new_certificate.pemopenssl rsa -inform DER -outform pem -in old_key.der -out new_key.pem P7B转换为PEM openssl pkcs7 -print_certs -in old_certificate.p7b -out new_certificate.cer PFX转换为PEM openssl pkcs12 -in old_certificat.pfx -nokeys -out new_certificate.pemopenssl pkcs12 -in old_certificat.pfx -nocerts -out new_key.pem 若需要将PK CS 8格式私钥转换为PKCS1格式，则参考如下方法： openssl rsa -in old_certificat.pem -out pkcs1.pem

下行带宽/流量 选择需要查看的时间、播放域名、应用名称、流名称及时间粒度。单击页面右侧的“带宽”或“流量”，可以切换查看低时延直播的带宽、流量趋势图。 单击右侧的图标，可以导出具体数据。 支持查询最近365天的历史数据。 查询的时间跨度最长为31天。 最小统计粒度为5分钟，如2020-11-06 8:00:00~2020-11-06 8:04:59时间段内的数据，会统计展示在2020-11-06 8:00:00这个统计点上。其中，带宽为用户所选粒度时间内的平均值，流量为用户所选粒度时间内的累计值。 直播流名称需要根据播放端实际拉取的流进行填写，例如，播放端拉取的是转码流，则“流名称”中需要填写的是转码流名称。 导出数据暂不支持按运营商分类。 带宽用量趋势呈现的是所选域名对应低时延直播业务的总带宽趋势。您可以在带宽趋势区域的下方，查看所选域名在查询时间段内的下行带宽峰值，如图1所示。 图1 下行带宽统计详情 流量用量趋势呈现的是所选域名对应低时延直播业务的总流量趋势。您可以在流量趋势区域的下方，查看所选域名在查询时间段内的流量消耗，如图2所示。 图2 下行流量统计详情 流量表和流量趋势图中呈现的是低时延直播总流量，是将每5分钟粒度统计的流量进行合计（Byte），然后换算成MB，精确到小数点后两位。因此，可能与按5分钟粒度查询导出的流量表中“流量(MB)”列的合计值存在稍微的误差，这是由于计算时四舍五入导致。

观众数 选择需要查看的时间、播放域名、应用名称、流名称和时间粒度，即可查看低时延直播业务的趋势图。 支持查询最近365天的历史数据。 查询的时间跨度最长为31天。 仅支持选择单个域名进行查询。 统计的是独立IP数，最小统计粒度为1分钟，如2020-11-06 8:00:00~2020-11-06 8:00:59时间段内的数据会统计展示在2020-11-06 8:00:00这个统计点上。 趋势图中呈现的是所选域名对应低时延直播业务的在线独立访客数趋势，如图3所示。 图3 在线独立访客数趋势

单路播放统计 支持查看低时延直播的单路播放统计数据，包括：拉流成功率、在线观看人数、平均首屏时长、平均播放帧率、平均下行网络码率、平均卡顿率和CPU使用率。 选择需要查看的时间、播放域名、应用名称、流名称及时间粒度。单击，即可查看到所选播放域名对应低时延直播业务的单路播放统计数据。 支持查询最近365天的历史数据。 查询的时间跨度最长为31天。 最小统计粒度为1分钟，如2020-11-06 8:00:00~2020-11-06 8:00:59时间段内的数据会统计展示在2020-11-06 8:00:00这个统计点上。 支持查询Web、IOS和安卓端的单路播放统计数据。

Root CA机构颁发的证书 Root CA机构颁发的证书是一份完整的证书，配置HTTPS时，仅上传该证书即可。 通过记事本打开*.PEM格式的证书文件，可以查看到类似图1所示的全部证书信息。 PEM格式证书： 以证书链“-----BEGIN CERTIFICATE-----”开头，以证书链“-----END CERTIFICATE-----”结尾。 证书链之间的内容，要求每行64个字符，最后一行允许不足64个字符。 证书内容不包含空格。

中级CA机构颁发的证书 中级机构颁发的证书文件包含多份证书，配置HTTPS时，需要将所有证书拼接在一起组成一份完整的证书后再上传。拼接后的证书类似图2。 通过记事本打开所有*.PEM格式的证书文件，将服务器证书放在首位，再放置中间证书。一般情况下，机构在颁发证书的时候会有对应说明，请注意查阅相关规则。通用的规则如下： 证书之间没有空行。 证书链的格式如下： -----BEGIN CERTIFICATE----- -----END CERTIFICATE----- -----BEGIN CERTIFICATE----- -----END CERTIFICATE-----

注意事项 录制规则配置支持域名级、应用级和流级，优先生效细粒度配置（即流级别最优先），同级配置不支持多种录制类型。 直播服务不支持清理录制内容，仅记录直播录制事件，且直播录制事件的数据只保留30天。您可根据业务的实际需求，在OBS中手动清理录制文件或通过OBS生命周期管理功能实现录制文件的存留期限和策略。 直播录制过程中，若直播推流因网络抖动等问题中断，则直播服务将中止录制。当推流重新启动时，直播服务将重新开启新的录制任务。 配置录制后，启动推流即开始录制，结束推流才可停止录制，暂无法按需停启；若在推流过程中删除录制规则，录制仍然会继续，直到推流结束 。 OBS服务会因欠费停服，从而导致直播录制失败，建议您购买OBS存储包。 仅支持对接收到的源直播流进行录制，暂不支持录制直播转码流。

概述 视频直播服务为您提供了Referer防盗链、Key防盗链和IP黑白名单鉴权机制，对访问者的身份进行识别和过滤，符合规则的才可使用直播服务。 其中，Key防盗链鉴权功能旨在保护直播源站资源不被非法下载盗用。采用Referer防盗链方法添加Referer黑、白名单方式可以解决部分盗链问题。但是，由于Referer内容可以伪造，所以Referer防盗链方式不能很好的保护直播源站的资源。因此，建议采用Key防盗链鉴权方式保护直播源站资源更为安全有效。视频直播服务鉴权机制如表1所示。 表1 直播鉴权 项目 描述 配置 Referer防盗链 您可以配置访问的Referer黑白名单，对访问者身份进行识别和过滤。 请参见Referer防盗链。 Key防盗链 您可以配置防盗链Key，通过URL鉴权方式保障直播资源的安全。 请参见Key防盗链。 IP黑白名单 您可以配置访问的IP黑白名单，对访问者身份进行识别和过滤。 请参见IP黑白名单。 父主题： 播放鉴权

配置流程 消息订阅的配置流程，如图1所示。 图1 消息订阅配置流程图 创建消息主题：在 消息通知 服务控制台新建消息主题，用于消息发送和订阅通知。 添加订阅：将消息主题添加到订阅中接收发布至主题的消息，在订阅主题且确认订阅后，终端节点能够接收到向该主题发布的所有消息。 设置主题策略：授权直播服务可对该主题发布消息。 配置直播消息订阅：在直播控制台配置消息订阅，在直播推流开始和结束，以及录制时收到对应的消息通知。

录制通知消息模板 录制通知的消息模板如下所示，消息中各字段说明如表3所示。 Live Record Notify, domain: {domain}, app_name: {app_name}, stream_name: {stream_name}, download_url: {download_url}, filename: {filename},asset_id: {asset_id}, duration: {duration}, event: {event}, timestamp: {timestamp} 表3 RecordNotifyTemplate字段说明 字段 描述 domain 推流域名。 app_name 应用名称，与推流地址中的AppName保持一致。 stream_name 直播流名称。 download_url 录制文件的下载地址，当event的值不为RECORD_NEW_FILE时，该字段为空。 filename 录制文件的名称，当event的值不为RECORD_NEW_FILE时，该字段为空。 asset_id 录制文件的媒资ID，点播服务分配给该录制文件的唯一标识，当event的值不为RECORD_NEW_FILE时，该字段为空。 duration 录制文件的时长，当event的值不为RECORD_NEW_FILE时，该字段为0。 event 录制事件，包括： RECORD_START： 录制任务开始。 RECORD_NEW_FILE：产生新的录制文件。 RECORD_OVER：录制任务结束。 RECORD_FAIL：录制任务失败。 timestamp 录制时间戳。

直播视频录制 标准直播和低时延直播都支持视频录制功能，操作流程相同，如下所示。 直播录制是指在直播推流时将直播内容进行录制并将录制的视频存储到OBS（ 对象存储服务 Object Storage Service）中，然后在OBS中对录制的直播视频进行下载、分享等处理。 因直播录制文件最终存储在OBS中，所以您需要在OBS中创建存储桶，操作请参见创建桶。其中，OBS服务计费情况，请参见OBS产品价格详情。 您需要授权直播服务使用OBS桶存储录制文件，操作请参见云资源授权。 您可以设置直播录制格式、周期等，操作请参见配置录制模板。 如您想实时了解直播录制状态，可在直播录制前配置录制回调，操作请参见配置录制回调。 开始直播推流。 直播录制完成后，您可以在直播、OBS服务中管理录制文件，如预览、下载、分享等，操作请参见管理录制文件。 父主题： 快速入门

日志说明 日志命名规则：播放域名_日志时间.log.gz 日志生成规则：日志默认按5分钟粒度进行分割，若域名无请求，则不会产生日志数据包。正在进行拉流的直播日志一般4个小时后才能获取到最完整的日志文件。 日志格式： 标准直播场景： [time_local]|play_domain|client_ip|cdn_ip|url|http_code|cache_hit|scheme|method|period_bytes_sent|period_duration|ua|refer|app|stream 低时延直播场景： [time_local]|play_domain|client_ip|cdn_ip|url|http_code|cache_hit|scheme|method|period_bytes_sent|period_duration|ua|refer|app|stream 若某字段不涉及或为空时，用-表示；若字段信息中存在空格，则空格需带上英文双引号""。 日志示例： 标准直播场景 [06/Mar/2023:06:51:26 +0800]|pullexample.huaweicloud.com|49.1.1.*|42.11.1.2|http://pullexample.huaweicloud.com/live/stream-123.flv|200|HIT|HTTP|GET|1024|4|Lavf/58.12.100|-|live|stream-123 低时延直播场景： [06/Mar/2023:06:51:26 +0800]|pullexample.huaweicloud.com|49.1.1.*|42.11.1.2|webrtc://pullexample.huaweicloud.com/live/stream-123.sdp|200|HIT|WebRTC|GET|1024|4|Lavf/58.12.100|-|live|stream-123 各字段的含义如表1所示。 表1 日志字段含义说明 字段名 字段含义 字段示例 time_local 通用日志格式下的本地时间，标记本次统计的时间值。 [06/Mar/2023:06:51:26 +0800] play_domain CDN加速 域名。 pullexample.huaweicloud.com client_ip 客户端IP。 49.1.1.* cdn_ip 播放用户接入的CDN节点IP。 42.11.1.2 url 完整的访问url。 标准直播 http://pullexample.huaweicloud.com/live/stream-123.flv 低时延直播 webrtc://pullexample.huaweicloud.com/live/stream-123.sdp http_code HTTP状态码。 200 cache_hit 缓存命中状态，有如下两种： HIT MISS HIT scheme 访问协议，有如下四种： HTTP HTTPS RTMP WebRTC 标准直播：HTTP、HTTPS或RTMP 低时延直播：WebRTC method HTTP方法 GET period_bytes_sent 周期内发送字节数，对应的统计周期时间为period_duration。 1024 period_duration 统计周期，单位：s，精度到秒。 4 ua User - Agent信息。 Lavf/58.12.100 refer Referer信息。 - app 挂载点 live stream 流名 stream-123

示例流程 图1 给用户授权Live只读权限流程 创建用户组并授权 在 IAM 控制台创建用户组，并授予Live只读权限“Live ReadOnlyAccess”。 创建用户并加入用户组 在IAM控制台创建用户，并将其加入1中创建的用户组。 用户登录并验证权限 新创建的用户登录控制台，切换至授权区域，验证权限： 在“服务列表”中选择视频直播服务，进入“域名管理”界面进行添加域名操作，若提示权限不足，则表示“Live ReadOnlyAccess”已生效。