视频点播的上传存储设置包括上传设置、外网访问设置和存储设置。本文为您介绍上传存储设置的功能介绍、前提条件、注意事项和具体操作说明。

功能介绍

• 上传自动触发设置：包含自动生成封面、自动生成封面候选、视频元信息提取方式、低频存储自动提取视频元信息、归档存储自动提取视频元信息、视频元信息提取 md5、自动触发默认工作流、自动设置视频状态、覆盖上传等。视频上传完成后，系统会根据您的设置自动触发。
• 默认配置：支持设置默认工作流。
• 外网访问设置：关闭 URL 鉴权后，基本信息中的读写权限切换为公共读，互联网上任何用户都可以对该 Bucket 内的文件进行访问。
• 存储设置：默认点播存储。完成对象存储授权后，支持添加对象存储 Bucket。

注意事项

• 上传设置对空间内所有上传的视频资源生效。
• 提交修改上传设置中的上传自动触发设置和默认配置后，需要一些时间（通常为 5 - 10 分钟）才能生效，请耐心等待生效后再继续操作。
• 如果您在调用 API 时指定了工作流，将不会再使用默认工作流。
• 2022年 11 月 01 日之前创建的空间不支持添加对象存储 Bucket。
• 当前默认支持挂载**华北2（北京）**区域。

  说明

  如果您需要挂载华东2（上海）、华南1（广州）区域，请联系我们开通白名单功能。

• 存储设置中默认转码后的文件和片源在同一个 Bucket 中。如果您需要添加水印，水印文件需要与片源在同一个 Bucket 中。

上传自动触发设置

自动生成封面

开启自动生成封面时，视频上传成功后，系统将自动选择第一张非黑帧作为视频封面。系统会根据某帧中的黑色元素是否超过 80% 来判断该帧是否为黑帧。若要开启自动生成封面功能，请按以下步骤：

1. 登录视频点播控制台，进入指定空间。
2. 单击左侧导航栏系统设置 > 上传存储设置。
3. 在上传设置页签下，单击上传自动触发设置区域内的修改配置按钮。
4. 开启自动生成封面开关。
5. （可选）单击高级设置按钮，开启自定义文件路径开关。您可以输入固定字符串和变量来自定义生成的封面文件路径。详情规则请参见截图变量详细说明。

   说明

   • 不支持以 /、\ 开头，不支持连续 /、空格、+ 等特殊字符。
   • 不支持 {{count}} 变量。
6. 单击确定按钮。

自动生成封面候选

开启自动生成封面候选时，视频上传成功后，系统将智能抽取 8 个关键帧作为候选封面。若要开启自动生成封面候选功能，请按以下步骤：

1. 登录视频点播控制台，进入指定空间。
2. 单击左侧导航栏系统设置 > 上传存储设置。
3. 在上传设置页签下，单击上传自动触发设置区域内的修改配置按钮。
4. 开启自动生成候选封面开关。
5. 单击确定按钮。

自动触发默认工作流

1. 登录视频点播控制台，进入指定空间。
2. 单击左侧导航栏系统设置 > 上传存储设置。
3. 在上传设置页签下，单击上传自动触发设置区域内的修改配置按钮。
4. 切换自动触发默认工作流开关。
5. 单击确定按钮。

自动设置视频状态

在视频点播中，音视频资源的发布状态分为发布和未发布。默认情况下，上传到视频点播的音视频的状态为未发布，无法获取播放地址进行播放。因此，在播放音视频之前，您必须将音视频的发布状态修改为已发布。参考以下步骤自动设置视频状态：

1. 登录视频点播控制台，进入指定空间。
2. 单击左侧导航栏系统设置 > 上传存储设置。
3. 在上传设置页签下，单击上传自动触发设置区域内的修改配置按钮。
4. 将自动设置视频状态设为发布。
5. 单击确定按钮。

覆盖上传

覆盖上传是指上传具有相同文件路径的新媒资文件，替换之前上传的旧媒资文件。

参考以下步骤开启覆盖上传：

1. 登录视频点播控制台，进入指定空间。
2. 单击左侧导航栏系统设置 > 上传存储设置。
3. 在上传设置页签下，单击上传自动触发设置区域内的修改配置按钮。
4. 切换覆盖上传开关。
5. 单击确定按钮。

上传完成回调返回媒资播放地址

此功能开启时，媒资上传完成事件中会返回视频播放地址。同时，您还需将自动设置视频状态为发布。

参考以下步骤开启此功能：

1. 登录视频点播控制台，进入指定空间。
2. 单击左侧导航栏系统设置 > 上传存储设置。
3. 在上传设置页签下，单击上传自动触发设置区域内的修改配置按钮。
4. 切换上传完成回调返回媒资播放地址开关。
5. 单击确定按钮。

上传完成回调返回工作流任务 ID

此功能开启时，如果您在上传音视频时触发工作流任务，媒资上传完成事件中会返回工作流任务 ID。参考以下步骤开启此功能：

1. 登录视频点播控制台，进入指定空间。
2. 单击左侧导航栏系统设置 > 上传存储设置。
3. 在上传设置页签下，单击上传自动触发设置区域内的修改配置按钮。
4. 切换上传完成回调返回工作流任务 ID 开关。
5. 单击确定按钮。

转码配置（设置默认工作流）

1. 登录视频点播控制台，进入指定空间。
2. 单击左侧导航栏系统设置 > 上传存储设置。
3. 在上传设置页签下，单击转码配置区域内的修改配置按钮。
4. 在下拉列表中选择工作流。如需创建工作流，请见工作流。
5. 单击确定按钮。

上传提取元信息配置

视频元信息提取方式

对于上传到视频点播、标准存储的音视频资源，视频点播默认会提取视频分辨率、时长、码率等元信息。视频点播支持以下两种视频元信息提取方式：

• 同步+异步提取：（默认）优先同步提取元信息，仅在极少数同步提取超时的情况下采用异步提取。同步抽取元信息是指在 CommitUploadInfo 接口中抽取元信息。适用于上传完成后需要立即获取媒资信息的情况。
• 异步提取：采用全异步提取的方式。适用于对上传速度要求较高的情况。

参考以下步骤设置视频元信息提取方式：

1. 登录视频点播控制台，进入指定空间。
2. 单击左侧导航栏系统设置 > 上传存储设置。
3. 在上传设置页签下，单击上传提取元信息配置区域内的修改配置按钮。
4. 单击同步+异步提取（默认）或者异步提取方式。
5. 单击确定按钮。

低频存储自动提取视频元信息

对于低频存储的文件，开启此功能会产生低频数据取回费用。详见低频存储计费。参考以下步骤开启此功能：

1. 登录视频点播控制台，进入指定空间。
2. 单击左侧导航栏系统设置 > 上传存储设置。
3. 在上传设置页签下，单击上传提取元信息配置区域内的修改配置按钮。
4. 切换低频存储自动提取视频元信息开关。
5. 单击确定按钮。

归档存储自动提取视频元信息

对于归档存储的文件，开启此功能会产生归档数据取回费用。详见归档存储计费。参考以下步骤开启此功能：

1. 登录视频点播控制台，进入指定空间。
2. 单击左侧导航栏系统设置 > 上传存储设置。
3. 在上传设置页签下，单击上传提取元信息配置区域内的修改配置按钮。
4. 切换归档存储自动提取视频元信息开关。
5. 单击确定按钮。

视频元信息提取 MD5

默认情况下，如果上传的文件大小在 16 MB 以内，系统会提取 MD5 信息。如果您需要确保所有上传的文件均提取 MD5 信息，请开启视频元信息提取 MD5。

1. 登录视频点播控制台，进入指定空间。
2. 单击左侧导航栏系统设置 > 上传存储设置。
3. 在上传设置页签下，单击上传提取元信息配置区域内的修改配置按钮。
4. 切换视频元信息提取md5开关。
5. 单击确定按钮。

上传加速设置

详见跨地域上传加速。

外网访问设置

如您在视频点播服务中未配置加速域名，则会通过互联网从点播存储地址直接下载或播放视频源文件。

1. 登录视频点播控制台，进入指定空间。
2. 单击左侧导航栏系统设置 > 上传存储设置。
3. 在外网访问设置页签下，您可查看以下基本信息：
   • 区域：点播存储桶的所在区域，默认为华北1。
   • 存储地址：系统自动生成的点播存储地址。
   • 创建时间：点播存储桶的创建时间。
   • 读写权限：默认为私有。开启 URL 鉴权时，读写权限为私有；关闭 URL 鉴权时，读写权限为公共读。
4. 您可单击页面下方修改配置按钮，进行以下操作：

   1. 设置 URL 鉴权。用户请求必须携带一个由多个字段计算得到的签名。只有当请求中携带的签名与服务端计算得到的签名匹配时，请求才会被接受。配置更新大约需要 5 分钟生效。目前仅支持 Type A 类型，具体参数说明如下：

      参数	说明
      状态	默认为开启。若关闭 URL 鉴权，读写权限将切换为公共读，互联网上任何用户都可以对该 Bucket 内的文件进行访问，有可能造成数据外泄以及费用激增，请谨慎操作。
      类型	固定为 A 类型。
      签名主 Key	设置一个主密钥。密钥由长度为 6-40 个字符组成，只能包含除了 Delete（ASCII code 127）的可打印 ASCII 字符。
      签名备 Key	设置一个备密钥。密钥的要求与主 key 相同。
      签名参数	设置请求的签名参数名称。默认为 auth_key，支持自定义，但是不能设置为 timestamp。参数名称不能超过 100 个字符，支持由字母、数字、下划线 _、中划线 -、句号 .、逗号 ,、感叹号 ! 。同时，参数名称至少包含一个字母或者数字。
      有效时间	设置签名的有效时间，默认为 1800，单位为秒。取值范围为 [0,315,360,000]。 该字段与签名参数搭配使用，用来计算签名的过期时间。 签名的过期时间 = 签名参数 + 有效时间。视频点播收到某个请求时，如果请求中包含的签名的过期时间小于当前时间，视频点播判定签名已过期。此时，视频点播返回 403 响应状态码，表示鉴权失败。
      时间格式	固定为十进制（Unix 时间戳）

   2. 设置 IP 黑白名单。仅允许或者禁止来自特定 IP 的请求访问点播存储地址。IP 黑白名单具体参数说明如下：

      • 状态：默认关闭，您可通过编辑更改状态。
      • 类型：可选白名单或者黑名单。
      • IP：输入 IP 地址。IP 要求的规则如下：
        • 支持 IP 格式（ IPv4 或 IPv6）、 CIDR 网段。
        • 多个 IP 地址以 ; 分隔，或一行一个。不超过 1000 个。
        • 长度限制为 1 到 30,000 个字符。

添加对象存储 Bucket

上传至视频点播服务的媒资默认会存储在点播存储服务中。如果您已经有大量媒体文件存储在对象存储 TOS 服务的 Bucket 中，并且不方便将其迁移到视频点播存储中，则可将自己的对象存储 Bucket 添加到视频点播服务中。这样，您就能够对存储在对象存储 Bucket 中的媒体文件进行转码、画质增强、截图、播放等操作。

注意事项

• 当前支持挂载华北2（北京）、华东2（上海）、华南1（广州）区域。
• 2022 年 11 月 01 日之前创建的空间不支持添加对象存储 bucket。
• 不支持重复挂载。例如，对象存储的 Bucket A 挂载在视频点播的空间 A 后，不可再挂载至空间 B。
• 默认情况下，转码后的文件和片源在同一个 Bucket 中。如果您需要添加水印，水印文件需要与片源在同一个 Bucket 中。

媒体处理能力支持情况

对于点播挂载 TOS 和点播存储，媒体处理能力的支持情况存在差异，具体如下：

操作步骤

授权并添加对象存储 Bucket 的步骤如下：

1. 登录视频点播控制台，进入指定空间。
2. 单击左侧导航栏系统设置 > 上传存储设置。
3. 在存储设置页签下，单击添加存储地址。
   
4. 在弹框中选择 bucket。支持输入前缀进行搜索。
5. 将挂载的 Bucket 设为默认存储地址。
   

   说明

   默认存储切换有 3 分钟灰度时间。期间上传的视频可能会存储在切换前的默认存储中。

后续操作

• 添加域名：添加对象存储 Bucket 后，如需从视频点播服务获取播放地址，您需要添加域名，并将回源存储设为对象存储地址，如下图所示。
  
• 上传媒资：添加对象存储 Bucket 后，您既可通过视频点播上传视频文件，也可通过对象存储上传视频文件。

  注意

  挂载区域为华东2（上海）、华南1（广州）时，不支持通过视频点播服务上传视频。

• 触发媒体处理：
  • 通过视频点播上传的视频文件，发起处理任务的方式如下：
    • 通过视频点播控制台指定单个媒体处理模板来触发转码任务，具体请见触发媒体处理。
    • 设置空间级别的默认工作流、上传时指定工作流 ID 或上传后手动触发工作流。具体操作请见触发工作流。
  • 通过对象存储上传的视频文件，可调用 StartWorkflow 接口触发媒体处理。您需要传入工作流 ID。
• 查看处理结果：
  • 在视频点播控制台查看任务进度和处理结果。具体操作请参见工作流任务。
  • OpenAPI 或服务端 SDK：
    • 调用 GetWorkflowExecution 接口查看工作任务列表信息。
    • 调用 GetWorkflowExecutionResult 接口获取工作流执行结果。
• 获取视频播放地址：
  • 在视频点播控制台获取视频播放地址。
  • 调用 GetPlayInfo 接口获取视频播放地址。