点播服务提供了多种主流语言的SDK,您可以基于服务端SDK编写代码来调用点播API,让您不用复杂编程即可快捷访问点播服务。

功能介绍

  • SDK封装了对API的调用请求和响应,避免自行计算较为繁琐的签名机制
  • 支持所有的点播服务API,并提供了相应的示例代码。
  • 支持7种开发语言,包括:Java、Python、PHP、.NET、Node.js、Go、C/C++。
说明 通常在发布新的API后,阿里云会及时同步更新SDK,所以即便您没有找到对应API的示例代码,也可以参考旧的示例自行实现调用。

前提条件

  • 服务开通
  • 账号准备

    准备好访问点播服务使用的Access Key,支持主账号、子账号、STS三种方式访问,相关概念和介绍请参见账号和授权

    • 主账号访问:在阿里云Access Key管理创建主账号Access Key。
      注意 使用主账号权限过大,一旦泄露可能会对您造成损失,不建议使用。
    • 子账号访问:在RAM访问控制台创建子账号,并授予VOD权限(如AliyunVODFullAccess)后进行相应操作,请参见创建RAM用户并授权
      说明 为确保账号安全,强烈建议使用子账号访问点播服务。
    • STS方式:点播服务也支持使用STS方式访问,请参见创建角色并进行STS临时授权

开发环境

服务端SDK支持Linux、Windows、Mac等多种平台和运行环境,请提前安装好对应开发语言的编译器或解释器,并完成相关环境配置,具体版本要求可参考各语言SDK的安装文档。

说明 仅C/C++版SDK暂不支持Windows,后续会支持。

SDK安装

访问域名

点播服务在全球提供了多个接入地址,更多内容请参见点播中心和访问域名,通过API接入区域(API Region)来初始化客户端实例,接入区域标识对应API/SDK的RegionId参数,例如上海为cn-shanghai,新加坡为ap-southeast-1
注意 接入地址的区域与存储区域是不一样的概念,接入区域表示API的接入点,存储区域对应OSS的区域,如API接入点在上海(cn-shanghai),但媒体文件可能存储在北京(cn-beijing)。

使用限制

点播服务对资源使用,以及API的调用次数等都有默认限制,更多内容请参见使用限制,如要提高限制,可联系售后,或提工单联系我们,并请详细说明使用场景和预期的阈值(如域名数、播放接口访问频次等)。

调用示例

各语言版本的SDK都提供了完整的API调用示例,请参见各语言SDK安装文档同层级目录的示例文档,如媒体上传、音视频播放等。

常见错误

可以根据错误代码排查SDK使用中的问题,以下是各语言的常见错误: 实际上,各语言版本的SDK常见错误具有相通性,可以互相参考,大部分错误解决方法不需要局限于语言,如InvalidAccessKeyId.NotFound等错误,PHP也可以参考上述语言的方法解决。

提交反馈

如果您在使用SDK的过程中遇到任何问题,欢迎前往阿里云SDK问答社区提问,提问前请您阅读反馈引导。更多内容请参见提交反馈