内容分发网络CDN

    设置视频拖拽

    百度云支持对flv与mp4伪流视频的拖拽功能,开启拖拽可降低回源率,提升速度。本接口用于设置视频拖拽的参数。(注意:此接口为全量接口,设置时需要将已有的设置一并写入,否则原有配置会被覆盖。)

    Method Path 说明
    PUT /v2/domain/{domain}/config?mediaDrag 设置视频拖拽的参数

    domain:CDN加速域名

    请求体(Request Body)

    参数 可选 类型 说明
    mediaDragConf 必选 MediaDragConf 视频拖拽的设置

    MediaDragConf:

    参数 可选 类型 说明
    mp4 可选 MediaDrag mp4类型伪流的拖拽设置,如果是取消设置,请不要带上这个字段
    flv 可选 MediaDrag flv类型伪流的拖拽设置,如果是取消设置,请不要带上这个字段

    MediaDrag:

    参数 可选 类型 说明
    fileSuffix 可选 list类型,元素类型为String 百度智能云CDN支持MP4文件的伪流(pseudo-streaming)播放,通常这些文件拓展名为.mp4,.m4v,.m4a,因此这个fileSuffix值为文件拓展名集合,如: ["mp4", "m4v", "m4a"],type为mp4,fileSuffix默认值为["mp4"];type为flv,fileSuffix默认值为["flv"]
    startArgName 可选 String start参数名称,默认为“start”,您可以自定义参数名称,但是要求不能和endArgName相同
    endArgName 可选 String end参数名称,默认为“end”,您可以自定义参数名称,但是要求不能和startArgName相同
    dragMode 必选 string mp4类型按秒进行拖拽,flv类型按字节进行拖拽。type为flv可选择的模式为“byteAV”或”byte”;type为mp4只能是"second"模式

    响应码 (Http Status Code)

    HTTP Status Code 说明
    200 成功
    400 更新失败,参数错误等

    请求示例1

    PUT /v2/domain/myself.baidu.com/config?mediaDrag HTTP/1.1
    Host: cdn.baidubce.com
    Content-Length: 130
    Content-Type: application/json
    
    {
        "mediaDragConf":{
            "mp4":{
                "fileSuffix":[
                    "mp4",
                    "m4a"
                ],
                "startArgName":"startIndex",
                "dragMode":"second"
            },
            "flv":{
                "dragMode":"byteAV"
            }
        }
    }

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json; charset=utf-8
    Transfer-Encoding: chunked
    
    {
        "status":"RUNNING"
    }

    请求示例2 取消flv类型伪流的拖拽设置,保持mp4类型伪流的拖拽设置不变 此时请求体中不加flv参数,但是为保持mp4类型伪流的拖拽设置不变,请求体中的mp4参数一定要为当前该domain的mp4参数值一致(当前该domain的mp4参数值可以通过查询视频拖拽接口获取)。

    PUT /v2/domain/myself.baidu.com/config?mediaDrag HTTP/1.1
    Host: cdn.baidubce.com
    Content-Length: 130
    Content-Type: application/json
    
    {
        "mediaDragConf": {
            "mp4": {
                "fileSuffix": [
                    "mp4",
                    "m4a"
                ],
                "startArgName": "startIndex",
                "dragMode": "second"
            }
        }
    }

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json; charset=utf-8
    Transfer-Encoding: chunked
    
    {
        "status":"RUNNING"
    }

    请求示例3 修改mp4类型伪流的拖拽设置的dragMode设置项,保持flv类型伪流的拖拽设置不变 此时请求体中mp4参数的dragMode设置为目标值,mp4的其余参数保持和当前该domain的对应参数一致,否值会被覆盖为默认值。请求体中的flv参数一定要为当前该domain的mp4参数值一致)。

    PUT /v2/domain/myself.baidu.com/config?mediaDrag HTTP/1.1
    Host: cdn.baidubce.com
    Content-Length: 130
    Content-Type: application/json
    
    {
        "mediaDragConf":{
            "mp4":{
                "fileSuffix":[
                    "mp4",
                    "m4a"
                ],
                "startArgName":"startIndex",
                "dragMode":"second"
                "dragMode":"--目标值---"
            },
            "flv":{
                "dragMode":"byteAV"
            }
        }
    }

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json; charset=utf-8
    Transfer-Encoding: chunked
    
    {
        "status":"RUNNING"
    }
    上一篇
    查询页面优化
    下一篇
    查询视频拖拽