使用多应用体系前,请先阅读概述了解相关介绍和设定,并开通点播服务。本文为您介绍使用多应用的步骤、注意事项和常见问题。

使用流程

如果您已开通点播服务,则可按照如下步骤使用多应用。

流程图

申请开通

  • 申请条件

    视频点播多应用体系处于公测期,点播控制台还未上线,满足以下条件的用户可进行申请。

    近7天加速流量带宽峰值到达500 Mbps及以上。关于如何查看流量带宽峰值,请参见用量查询

  • 开通后影响
    • 不能禁用默认应用,否则会影响线上正常服务。
    • 控制台上不能操作和查询除默认应用外的资源(媒资库、审核列表、媒体处理配置等)。
    • 新创建的应用需要调用API重新创建转码配置、回调配置等。
    说明
    • 如果是测试回调功能,可以通过上传时设置不同环境的回调地址来测试。
    • 如果是做媒资隔离,可以用媒资分类。
  • 开通方法

    如果满足开通条件,且接受以上影响,请填写宜搭信息申请

    说明 申请信息中,请注明“已知晓多应用开通后的影响,可以接受,现申请开通多应用”,以及主账号UID

创建应用

调用接口创建应用(单个账号创建应用个数上限为10个,应用名称不能重复)。关于创建应用接口,请参见创建应用

说明 首次创建必须使用主账号AccessKey才能创建应用,后续授予RAM用户应用管理员权限后即可操作应用和授权。

为身份实体授权

调用接口进行授权,授权后该身份实体(RAM用户或角色)可以对应用下资源进行管理,关于授权接口,请参见为身份实体附加应用授权。关于权限策略,请参见权限策略

使用多应用

支持多应用的服务,会增加对参数AppId的支持,创建资源或新的设置时可指定此参数,查询数据时也仅会返回拥有权限的应用下的资源,而修改或删除时会校验相关权限。

当前,仅消息回调媒资服务(上传、播放和媒资管理)支持多应用。

  • 消息回调

    可为每个应用设置独立的消息回调方式和地址,配合API(设置事件通知配置)使用:

    • 指定AppId,可设置该应用下的消息回调。
    • 未指定时,则使用系统默认应用。

    完成设置后,不同应用下上传的视频、图片等产生的事件通知会根据其设置进行相应回调。也可使用查询事件通知配置接口查询相关配置。

    说明 开启多应用后,控制台暂时只能管理默认应用的回调配置。后续会迭代升级支持不同应用的管理。
  • 媒资服务
    • 媒体上传:上传相关接口(获取视频上传地址和凭证、获取图片上传地址和凭证等)支持指定AppId, 前提是该账号实体拥有该应用的权限,无权限则无法上传,不指定应用ID则上传到系统默认应用。
    • 音视频播放:只能获取到授权应用下的播放信息(播放凭证、播放地址等)。
    • 修改删除:修改和删除媒资相关操作只能操作有权限的应用下的资源。
    • 媒资查询:查询媒资详情接口,只能获取到有权限的应用下的媒资信息。批量查询时,只返回有权限的媒资数据,无权限的MediaId会放入NonExistMediaIds(字段名可能略有不同)。
    • 媒资搜索:搜索时只返回有权限的应用下的媒资数据,搜索条件中可指定一个或多个AppId。
    说明 开启多应用后,控制台媒资库暂时只能管理授权应用下的媒体资源;后续会迭代升级支持不同应用的管理。

常见问题

使用多应用过程中的常见问题及解决方案,请参见多应用体系常见问题