视频点播 VOD视频点播 VOD

更新时间:2021/09/18 GMT+08:00
分享

视频更新

功能介绍

媒资创建后,单独上传封面、更新视频文件或更新已有封面。

如果是更新视频文件,更新完后要通过确认媒资上传接口通知点播服务。

如果是更新封面或单独上传封面,则不需通知。

更新视频可以使用分段上传,具体方式可以参考示例2:媒资分段上传(20M以上)

调试

您可以在API Explorer中调试该接口。

URI

PUT /v1.0/{project_id}/asset

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取方法请参考获取项目ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token,使用Token鉴权方式时必选。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

Authorization

String

使用AK/SK方式认证时必选,携带的鉴权信息。

X-Sdk-Date

String

使用AK/SK方式认证时必选,请求的发生时间。

表3 请求Body参数

参数

是否必选

参数类型

描述

asset_id

String

媒资ID。

video_md5

String

视频文件MD5值。

建议参考媒资上传和更新生成对应的MD5值。

video_name

String

视频文件名。

文件名后缀为可选。

video_type

String

视频文件类型。 取值为MP4、TS、MOV、MXF、MPG、FLV、WMV、AVI、M4V、F4V、MPEG、3GP、ASF、MKV

cover_id

Integer

封面ID。

取值范围:[0,7]。

当前只支持一张封面,只能设置为0。

cover_type

String

封面图片格式类型。

取值如下:

  • JPG

  • PNG

cover_md5

String

封面文件的MD5值。

subtitles

Array of Subtitle objects

字幕文件信息

表4 Subtitle

参数

是否必选

参数类型

描述

id

Integer

字幕id。

取值范围:[1,8]。

type

String

字幕文件类型,目前暂只支持“SRT”。

language

String

字幕语音类型。

取值如下:

  • CN:表示中文字幕。

  • EN:表示英文字幕。

md5

String

字幕文件的MD5值。

description

String

字幕描述。

响应参数

状态码: 200

表5 响应Body参数

参数

参数类型

描述

asset_id

String

媒资ID。

video_upload_url

String

视频上传地址。

用于客户端上传不超过20MB的小视频文件(<=20MB)。该URL中携带了临时授权信息,当文件大于20MB时,需要采用分段方式上传。

您可以使用PUT请求向“video_upload_url”中上传视频文件。其中,“Content-Type”需要根据上传的视频文件类型进行设置,如下所示:视频文件:video/视频格式,如:“video/mp4”。

cover_upload_url

String

封面上传地址,用于上传封面文件。

您可以使用PUT请求向“cover_upload_url”中上传封面图片。其中,“Content-Type”需要根据上传的封面文件类型进行设置,如下所示:图片文件:image/图片格式,如:“image/png”。

subtitle_upload_urls

Array of strings

字幕上传地址,用于上传字幕。

您可以使用PUT请求向“subtitle_upload_urls”中上传字幕文件。其中,“Content-Type”需要根据上传的字幕文件类型进行设置,如下所示:字幕文件:application/octet-stream。

状态码: 403

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

PUT https://{endpoint}/v1.0/{project_id}/asset

{
  "asset_id" : "f488337c31c8e4622f1590735b134c65",
  "cover_id" : "0",
  "cover_type" : "JPG",
  "subtitles" : [ {
    "id" : 1,
    "language" : "CN",
    "type" : "SRT",
    "md5" : "SqcyFjJZoDZaP8oKIY6rgQ==",
    "description" : "AAAAA"
  } ]
}

响应示例

状态码: 200

处理成功返回。

{
  "asset_id" : "f488337c31c8e4622f1590735b134c65",
  "cover_upload_url" : "https://obs.cn-north-4.myhuaweicloud.com:443/obs-vod-1/%7Bproject_id%7D/f488337c31c8e4622f1590735b134c65/cover/Cover0.jpg?AWSAccessKeyId=CBN2JOVSQVVUREU0RCSN&Expires=1518148410&Signature=DVwzU6ejlKlSdAbwFXaSy67JpuA%3D",
  "subtitle_upload_urls" : [ "https://obs-vod-1.obs.cn-north-4.myhuaweicloud.com:443/14ce1d4437164aba8b364ce15866154e/53a018d2dc53ca07eb5a07a839205c9d/subtitle/1.srt?AWSAccessKeyId=CBN2JOVSQVVUREU0RCSN&Expires=1534760131&Signature=twZPabMSf%2FO%2B2H3mpo3Gsqk1uIo%3D" ]
}

状态码: 403

处理失败返回。

{
  "error_code" : "VOD.10062",
  "error_msg" : "Media asset or resource does not exist, please check."
}

状态码

状态码

描述

200

处理成功返回。

403

处理失败返回。

错误码

请参见错误码

分享:

    相关文档

    相关产品