-
使用SDK设置视频封面
视频点播 提供的服务端SDK,对API接口进行了封装,您可以在
SDK中心 下载对应SDK,然后进行集成开发。 视频上传时设置封面:服务端SDK提供了本地上传、OBS转存、URL拉取三种媒资上传方法,可以在对应的方法中上传本地图片设置封面,或者截图设置封面。 视频更新时设置封面:服务端SDK支持在视频上传完成后,可以调用视频更新方法时上传本地图片,更新视频封面。 视频处理时设置封面:服务端SDK支持在视频上传完成后,可以调用音视频方法时设置截图参数,选择某张截图作为视频封面。
-
调用API设置视频封面 视频点播API支持通过媒资上传、视频更新、视频处理三种方式设置视频的封面图片。 视频上传时设置封面 视频点播提供了上传、OBS转存、URL拉取三种创建媒资的方式,其中上传方式创建媒资支持上传或截图封面,其它二种方式仅支持截图封面。具体如下所示: 上传方式创建媒资 上传封面:调用创建媒资:上传方式接口,在请求参数中设置“cover_type”,即上传封面的图片类型,然后在请求的返回参数中获取“cover_upload_url”,通过“cover_upload_url”上传封面图片即可。 截图封面:调用创建媒资:上传方式接口,在请求参数中设置“thumbnail”,设置截图类型,指定某张截图作为封面。 OBS转存和URL拉取方式创建媒资 分别调用创建媒资:OBS转存方式口或创建媒资:URL拉取注入接口,在请求参数中设置“thumbnail”,设置截图类型,指定某张截图作为封面。 视频更新时设置封面 调用视频更新接口,在请求参数中设置“cover_type”,即上传封面的图片类型,然后在请求的返回参数中获取“cover_upload_url”,通过“cover_upload_url”上传封面图片即可。 视频处理时设置封面 调用视频处理接口生成截图,然后指定某张截图作为封面。若您需要在已生成的截图中更换封面,则可以先调用查询媒资详细信息接口,获取该视频的截图URL,然后调用设置封面接口修改截图封面。
-
场景说明 随着视频点播存储视频文件量的增加,设置视频封面不仅能提升展示的美观性,还能方便通过封面查找相关视频。同时,上传的视频封面也将会生成对应的封面地址,实现加速分发,可以直接将封面与视频文件一同引用到网页中。 上传视频时,点播服务会默认截取视频第一秒的首帧作为封面图片。您也可以通过上传图片或截图封面来更新视频的封面。 上传封面:适用于需要通过封面表达视频的大概内容及重点的场景。在上传前,您需要提前线下设计一张JPG或PNG格式的封面图片。 截图封面:适用于希望将视频中的某个瞬间画面来设置成封面的场景。无需要额外准备工作,您可以直接使用视频点播的截图功能生成。 您可以通过以下方式自定义视频封面: 控制台设置视频封面 调用API设置视频封面 使用SDK设置视频封面
-
OBS转存 若在开通点播服务前,已在华为云OBS桶中存储了大量的音视频文件,希望使用视频点播的转码、截图等功能对这些音视频进行处理。您可以使用该功能将OBS桶中的音视频文件复制转存到点播服务中,然后使用点播服务的相关功能。 华为云点播服务提供的OBS转存功能有如下限制: 不支持跨区域转存,如“华北-北京四”OBS桶中的音视频只能转存到“华北-北京四”点播服务中。 转存是指将OBS桶中的音视频文件复制一份到点播服务中,因此,若OBS桶中的音视频不删除,则OBS和点播服务中都将会有相关的存储费用产生。 支持转存的格式如下所示: 视频文件格式:MP4,TS,MOV,MXF,FLV,MPG,WMV,AVI,M4V,F4V,MPEG,3GP,ASF,MKV,WEBM,RMVB,VOB,RM,MTS,DV,DAT,QT,M2T,SWF,M3U8。其中,M3U8仅支持URL拉取方式上传。 音频文件格式:MP3,OGG,WAV,WMA,APE,FLAC,AAC,AC3,MMF,AMR,M4A,M4R,WV,MP2,RA,CAF。 OBS转存方式暂只支持调用API实现,您可以调用创建媒资:OBS转存接口实现该功能。
-
本地上传 支持批量上传音视频文件,便于快速将媒资上传到点播服务中,使用浏览器登录控制台即可进行上传。 华为云点播服务提供的本地上传功能有如下限制: 控制台由于安全策略,长时间上传可能会由于登录失效导致大文件上传失败,在上传大量文件时,需要操作控制台,从而保证控制台不自动退出登录。 支持上传的格式如下所示: 视频文件格式:MP4,TS,MOV,MXF,FLV,MPG,WMV,AVI,M4V,F4V,MPEG,3GP,ASF,MKV,WEBM,RMVB,VOB,RM,MTS,DV,DAT,QT,M2T,SWF,M3U8。其中,M3U8仅支持URL拉取方式上传。 音频文件格式:MP3,OGG,WAV,WMA,APE,FLAC,AAC,AC3,MMF,AMR,M4A,M4R,WV,MP2,RA,CAF。
-
转码模板介绍 为了方便对点播服务熟悉程度不同的用户快速使用转码功能,点播服务提供了四种系统转码模板,若您是点播服务的新用户,建议您优先使用系统模板。 点播服务内置了如下四种系统转码模板: 不转码模板(non_transcoding_template_group ):对音视频进行不转码操作,若您在音视频处理中未选择其它转码模板,则该模板默认生效。由于上传到点播服务的音视频默认是不转码分发的,所以对于用户来说,该模板无实际使用场景。 视频转码模板(system_template_group):内置了常用的视频清晰度,该模板适用于对分辨率、码率、帧率等音视频具体参数不熟悉的用户。 转封装模板(original_template_group):只转换音视频的封装格式,不改变其它参数,该模板主要适用于只需改变格式,无分辨率和码率等改变需求的场景。 视频自适应转码模板(adaptive_template_group):支持视频画质增强功能,该模板适用于有修复视频受损图像需求的场景。 若您对于音视频的相关参数足够熟悉,且系统模板无法满足实际需求,您也可以选择自定义转码模板。
-
费用说明 音视频转码为计费项功能,默认为按需付费,建议您购买转码套餐包,更优惠。目前视频点播提供了三种转码包,各转码包的使用场景如下所示: H.264标准转码包 支持抵扣“视频编码”为“H.264”,且“高清低码”为“关闭”状态的视频转码。 支持抵扣音频转码,按“5/22”折算时长后进行抵扣。 H.264高清低码转码包:只能抵扣“视频编码”为“H.264”,且“高清低码”为“开启”状态的视频转码。 H.265标准转码包:只能抵扣“视频编码”为“H.265”,且“高清低码”为“关闭”状态的视频转码。 三种转码包都不支持抵扣使用转封装模板(original_template_group)产生的费用。
-
注意事项 音视频转码当前支持的输入格式如下所示: 支持输入的音视频文件格式:MP4、TS、MOV、FLV、MPG、MXF、WMV、ADTS、AVI、MKV、MPEG、VOB、RM、MTS等。 支持输入的视频编码格式:H.264、 H.265、 MPEG-2、MPEG-4、MJPEG、WMV1/2/3、ProRes 422等。 支持输入的音频编码格式:AAC、 AC3、EAC3、HE-AAC、MP2、MP3、PCM(s161e、s16be、s241e、s24be、dvd)、WMA等。 如果需要支持多转码模式,即同时保留不同模板的转码产物,需提交工单申请开通。
-
场景说明 通过点播服务加速分发的音视频可能被引用到各种业务场景,如产品官网、视频网站等,也可能在不同的终端进行播放,如web端、移动端。为适用于多样化的场景,点播服务提供了转码功能,支持改变音视频的编码格式、封装格式、分辨率、码率等参数,从而适用于不同的业务场景、播放终端及网络环境。 转码功能可以帮助您处理如下问题: 适配不同播放终端:您可以将原始音视频转码为更适应于各终端播放的格式,如MP4格式适用于网站点播的场景。 适配不同网络环境:您可以根据不同的网络带宽设置转码输出的码率,以适应不同的网络播放环境。 降低分发成本:支持压缩率更高的H.265编码格式,您也可以在转码时开启高清低码功能,在分辨率不变的情况下,码率下降20%左右,从而降低音视频的分发成本。 HLS内容保护:您可以在转码时开启HLS加密,对转码的HLS格式音视频进行加密,从而防止音视频被盗用后进行二次分发。 版权保护:您可以为视频添加自己独有的logo等标识水印,以宣示该视频的版权所属。 音视频提取:支持转码提取音频文件,主要适用于一些纯音频的场景,如电台、音频APP等。 禁用音频:同时也支持输出无音频的视频文件,主要适用于需要禁用原音频的场景。
-
恢复归档文件 勾选一个或多个归档存储类型的音视频文件,单击“恢复归档文件”。 弹出“恢复已被归档的文件”,如图4所示。 图4 恢复已被归档的文件 参数配置说明,如表3所示。 表3 参数说明 参数 说明 恢复模式 归档存储恢复为标准存储的恢复模式。 包含如下选项: 快速取回模式:取回时间约为6分钟。 标准取回模式:取回时间约为3~5小时。 恢复方式 归档存储恢复为标准存储的恢复方式。 包含如下取值: 临时取回:临时取回音视频文件后,将会生成一份标准存储类型的对象副本。此时用户可以访问OBS的音视频文件资源,但是临时恢复的归档文件不允许执行转码操作。 该副本具备有效期,会在有效期结束后自动删除。实际音视频文件还是归档存储类型。 永久取回:永久取回音视频文件,变更为标准存储类型。 副本有效期 临时取回归档存储类型的音视频文件,生成标准存储类型对象副本的保存时间。 单位:天。取值范围:1-30。 单击“确定”,完成归档存储文件的恢复操作。 到达取回时间后,刷新音视频管理界面。 临时取回的方式,可以看到音视频的存储类型为“归档存储”。 永久取回的方式,可以看到音视频的存储类型为“标准存储”。
-
查看媒资信息 您可以单击音视频所在行右侧的“管理”,查看下述信息。 基本信息 查看媒资名称,媒资ID,封面,字幕,时长,大小,上传时间,最近更新时间,类别,标签以及描述。若您的媒资属于OBS托管过来的,基本信息中还会有源路径和输出位置字段信息。 播放地址 查看原始文件以及转码后文件的清晰度,格式,视频编码格式,分辨率,码率,大小以及播放地址。 字幕与封面信息 若您为上传的文件添加了字幕和封面,可以在此页面查看其格式与地址。
-
功能介绍 开通视频点播服务后,您可以使用如下方式将音视频上传至点播服务,从而进行相关管理操作。 本地上传:支持将存储在本地磁盘的音视频文件上传到视频点播中。 URL拉取:支持基于音视频源文件URL,离线拉取上传到点播系统。 音视频托管:支持将OBS桶中的音视频文件托管给视频点播,从而通过点播处理音视频,并支持将处理后产生的媒资文件存储在OBS桶中。 您可以参考如下步骤进行视频上传,也可以参考视频指导来操作。
-
使用限制 支持上传的音视频文件格式如下所示: 视频文件格式:MP4,TS,MOV,MXF,FLV,MPG,WMV,AVI,M4V,F4V,MPEG,3GP,ASF,MKV,WEBM,RMVB,VOB,RM,MTS,DV,DAT,QT,M2T,SWF,M3U8。其中,M3U8仅支持URL拉取方式上传。 音频文件格式:MP3,OGG,WAV,WMA,APE,FLAC,AAC,AC3,MMF,AMR,M4A,M4R,WV,MP2,RA,CAF。 若上传的文件名有空格,上传后将会去除命名中的空格。 当前支持HLS媒资的注入和播放,但不支持对HLS源片进行截图、解析、转码等
媒体处理 操作,也不支持HLS音
视频审核 。
-
功能介绍 您可以根据需求对上传的视频文件进行截图,目前支持按时间间隔截图和指定时间点截图两种方式。截图完成后,可以将截图设置为视频封面。该功能按截图张数计费,具体计费请参见VOD产品价格详情。 按时间间隔截图:根据相同的时间间隔对视频截取多张图像,从视频首帧开始截图,以最后一帧截图结束,最大间隔不能超过12秒。 指定时间点截图:指定一组时间点,截取视频在这组时间点的图像,一组最多可以设置10个时间点。
-
API限制 视频点播服务对服务端API设置了调用次数限制,避免出现短时间内重复调用API,出现服务中断的情况。 表4 API流控限制 接口分类 接口名称 单租户接口流控 (单位:次数/分钟) 接口总体流控 (单位:次数/分钟) 媒资上传 创建媒资:上传方式 获取分段上传授权 确认媒资上传 桶授权 创建媒资:OBS转存方式 1500 12000 创建媒资:OBS托管方式 创建媒资:URL拉取注入 上传检验 100 1000 媒资处理 视频更新 媒资处理 取消媒资转码任务 音频提取 取消提取音频任务 创建审核媒资任务 设置封面 100 1000 媒资管理 删除媒资 媒资发布 媒资发布取消 修改媒资属性 100 1000 查询媒资信息 1500 24000 查询指定媒资的详细信息 查询媒资列表 1500 12000 (即将下线)OBS托管管理 查询托管任务 查询托管任务详情 100 1000 查询托管媒资详情 1500 12000 媒资预热 CDN预热 查询CDN预热 100 1000 媒资刷新 CDN刷新 查询CDN刷新 100 1000 媒资分类 创建媒资分类 修改媒资分类 删除媒资分类 查询指定分类信息 100 1000 密钥查询 密钥查询 1500 12000 统计分析 查询CDN统计信息 查询源站统计信息 查询TopN媒资信息 查询
域名 播放日志 查询媒资日播放统计数据 100 1000 水印模板管理 创建水印模板 修改水印模板 查询水印列表 删除水印模板 确认水印图片上传 100 1000 转码模板管理 创建自定义转码模板 查询转码模板列表 修改转码模板 删除自定义模板 100 1000 转码模板集合管理 创建转码模板组集合 修改转码模板组集合 查询自定义模板组集合 删除转码模板组集合 100 1000 转码产物管理 删除转码产物 100 1000 媒资存储模式管理 修改媒资降冷粒度 修改媒资文件在OBS的存储模式 查询媒资降冷配置 100 1000