文档首页 > > API参考> 媒资管理接口> 媒资发布

媒资发布

分享
更新时间: 2019/10/10 GMT+08:00

功能描述

将媒资设置为发布状态。支持批量发布。

请求URI

POST /v1.0/{project_id}/asset/status/publish

请求参数

表1 请求参数

参数

类型

说明

必选项(M)/可选项(O)

asset_id

Array of strings

媒资ID。

M

请求样例

{
  "asset_id": ["f488337c31c8e4622f1590735b134c65","07ba4d46463355e800c2f42f628f0631"]
}

返回参数

  • 处理成功时返回
    表2 处理成功返回参数

    参数

    类型

    说明

    asset_info_array

    Array of AssetInfo objects

    发布的媒资信息。

    表3 AssetInfo参数说明

    参数

    类型

    说明

    asset_id

    String

    媒资ID。

    status

    String

    媒资状态。

    取值如下:
    • UNCREATED:未创建(媒资ID不存在 )
    • DELETED:已删除
    • CANCELLED:上传取消
    • SERVER_ERROR:上传失败(点播服务端故障)
    • UPLOAD_FAILED:上传失败(向OBS上传失败)
    • CREATING:创建中
    • PUBLISHED:已发布
    • TRANSCODING:待发布(转码中)
    • TRANSCODE_FAILED:待发布(转码失败)
    • TRANSCODE_SUCCEED:待发布(转码成功)
    • CREATED:待发布(未转码)
    • NO_ASSET:该媒资不存在
    • DELETING:正在删除
    • DELETE_FAILED:删除失败
    • OBS_CREATING:OBS转存方式创建中
    • OBS_CREATE_FAILED: OBS转存失败
    • OBS_CREATE_SUCCESS: OBS转存成功

    description

    String

    媒资子状态或描述信息。

    对于媒资异常场景,描述具体的异常原因。

    对于正常场景,描述媒资的处理信息。

    base_info

    BaseInfo object

    媒资基本信息。

    play_info_array

    Array of PlayInfo objects

    转码文件的播放信息。

    • HLS或DASH:此数组的成员个数为n+1,n为转码输出路数。
    • MP4:此数组的成员个数为n,n为转码输出路数。
    表4 BaseInfo参数说明

    参数

    类型

    说明

    title

    String

    媒资标题。

    长度不超过128个字节,UTF8编码。

    video_name

    String

    媒资文件名。

    description

    String

    媒资描述。

    长度不超过1024个字节。

    category_id

    Integer

    媒资分类id。

    category_name

    String

    媒资分类名称。

    create_time

    String

    媒资创建时间。

    格式为yyyymmddhhmmss。必须是与时区无关的UTC时间。

    last_modified

    String

    媒资最近修改时间。

    格式为yyyymmddhhmmss。必须是与时区无关的UTC时间。

    video_type

    String

    音视频文件类型。

    取值如下:
    • 视频文件:MP4、TS、MOV、MXF、MPG、FLV、WMV、AVI、M4V、F4V、MPEG、3GP、ASF、MKV

    • 音频文件:MP3、OGG、WAV、WMA、APE、FLAC、AAC、AC3、MMF、AMR、M4A、M4R、WV、MP2

    tags

    String

    媒资标签。

    单个标签不超过16个字节,最多不超过16个标签。

    多个用逗号分隔,UTF8编码。

    meta_data

    MetaData object

    视频的元数据信息。

    经过视频解析后产生,包括封装格式、大小、分辨率、码率、帧率。

    video_url

    String

    原始视频文件的访问地址。

    cover_info_array

    Array of CoverInfo objects

    封面信息。

    source_path

    file_addr object

    媒资来源,仅当媒资来自音视频托管时,有该参数信息。

    output_path

    file_addr object

    媒资输出位置,仅当媒资来自音视频托管,且输出存储位置为租户桶时,有该参数信息。

    表5 CoverInfo参数说明

    参数

    类型

    说明

    cover_url

    String

    封面文件的下载地址。

    表6 MetaData参数说明

    参数

    类型

    说明

    duration

    Integer

    视频时长。

    video_size

    Integer

    视频文件大小。

    单位:字节。

    width

    Integer

    视频宽度(单位:像素)。
    • 编码为H.264的取值范围:[32,3840]之间2的倍数。
    • 编码为H.265的取值范围:[320,3840]之间4的倍数。

    hight

    Integer

    视频高度(单位:像素)。
    • 编码为H.264的取值范围:[32,2160]之间2的倍数 。
    • 编码为H.265的取值范围:[240,2160]之间4的倍数。

    bit_rate

    Integer

    视频平均码率。

    frame_rate

    Integer

    帧率(单位:帧每秒)。

    取值如下:
    • FRAMERATE_AUTO = 1,
    • FRAMERATE_10 = 2,
    • FRAMERATE_15 = 3,
    • FRAMERATE_2397 = 4, // 23.97 fps
    • FRAMERATE_24 = 5,
    • FRAMERATE_25 = 6,
    • FRAMERATE_2997 = 7, // 29.97 fps
    • FRAMERATE_30 = 8,
    • FRAMERATE_50 = 9,
    • FRAMERATE_60 = 10

    默认值:1。

    单位:帧每秒。

    codec

    String

    视频编码格式。

    取值如下:
    • MPEG-2
    • MPEG-4
    • H.264
    • H.265
    • WMV
    • Vorbis
    • AAC
    • AC-3
    • AMR
    • APE
    • FLAC
    • MP3
    • MP2
    • WMA
    • PCM
    • ADPCM
    • WavPack
    • UNKNOWN

    quality

    String

    清晰度。

    取值如下:
    • FULL_HD:超高清
    • HD:高清
    • SD:标清
    • FLUNENT:流畅
    • AD:自适应
    • 2K
    • 4K
    • UNKNOW
    表7 PlayInfo参数说明

    参数

    类型

    说明

    play_type

    String

    播放协议类型。

    取值如下:
    • hls
    • dash
    • mp4

    url

    String

    播放URL。

    encrypted

    Integer

    标记流是否已被加密。

    取值如下:
    • 0:表示未加密
    • 1:表示已被加密

    默认值:0

    meta_data

    Array of MetaData objects

    播放列表的元数据数组。

  • 处理失败时返回
    表8 处理失败时返回参数

    参数

    类型

    说明

    error_code

    String

    错误码。

    error_msg

    String

    错误描述。

返回样例

  • 处理成功返回(200 OK)
    {
      "asset_info_array": [
        {
          "asset_id": "f488337c31c8e4622f1590735b134c65",
          "status": "UNCREATED",
          "description": "Asset meta download fail, errorCode is VOD.100021010, errorMag is Internal server communication is abnormal",
          "base_info": {
            "title": "Avatar test test",
            "video_name": "Avatar_480P.mp4",
            "description": "Avatar, test",
            "category_id": -1,
            "category_name": "其他",
            "create_time": "20180209024019",
            "last_modified": "20180209024019",
            "video_type": "MP4",
            "tags": "mytags"
          }
        },
        {
          "asset_id": "07ba4d46463355e800c2f42f628f0631",
          "status": " UNCREATED",
          "description": "no asset"
        }
      ]
    }
  • 处理失败返回(400 Bad Request)
    {
      "error_code": "VOD.10062",
      "error_msg": "媒资或资源不存在,请检查。"
    }

错误码

错误码请参见错误码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区