友盟+搜索

{{errorMsg}}

概述

图片、短视频等多媒体资源的流畅度和稳定性是影响 App 用户体验的关键。为助力无线开发者轻松打造最流畅的 App,友盟携手阿里百川推出了“多媒体服务”(花名“顽兔”,“玩图”的谐音,文档中将统一使用“顽兔”代指多媒体服务)。

通过阅读本文,开发者将对顽兔提供的功能和如何快速入手顽兔有一个清晰的概念。

开发者可以在移动端轻松集成顽兔 SDK(安卓、iOS),享受高速的文件上传、下载等服务;也可以在服务端完成顽兔 SDK 集成(Java、PHP),不过需要自行管理移动端与服务端的通信链路。

除了上传、下载等基本功能,顽兔还通过简单的 API 提供了图片、视频等文件处理功能,通过控制台提供了使用情况查询、文件检索、域名绑定、防盗链等配置管理功能,针对用户的存量文件,还提供了文件搬家和镜像存储功能。

移动端上手指南

架构图

使用移动端 SDK,配合控制台,开发者即可最优、最高效获得顽兔提供的所有功能。开发者 App 集成顽兔 iOS 或 Android SDK 只需关注四个要素:

  1. 上传:调用移动端 SDK 接口,将手机上的图片、短视频等文件发送至顽兔的指定空间
  2. 加载:调用移动端 SDK 接口,或通过 url 的方式加载文件
  3. 鉴权:生成安全图片,打包进移动端 SDK,在上传时由 SDK 自动完成鉴权过程
  4. 管理:推荐用户直接使用控制台进行管理

使用向导

  1. 开通服务,创建空间用于文件存储,参考 接入指引
  2. 下载移动端 SDK,导入Demo工程,生成并替换安全图片,完成签名配置,参考 Android SDKiOS SDK
  3. 参照上传、下载等接口描述,熟悉 Demo,参考 Android SDKiOS SDK
  4. 将 SDK 导入目标 App,配置好安全图片,并根据需要调用相应接口,完成业务逻辑开发

服务端上手指南

架构图

有些开发者认为 App 与自己的服务器通信心里更踏实,所以即使在无法充分利用顽兔提供的双向加速能力,还要额外付出移动端与服务端通信开发、维护的成本的情况下,也愿意采用这种架构。开发者服务器集成服务端 SDK 需要关注的要素有:

  1. 自定义:用户需要自定义移动端与服务端通信的消息格式、鉴权方式,还需要自行采取措施保证上传的速度和稳定性
  2. 上传:调用服务端 SDK 接口,将移动端上传的文件发送至顽兔的指定空间
  3. 加载:移动端通过 url 的方式加载文件
  4. 鉴权:使用顽兔分配的 AK、SK 配置服务端 SDK,文件上传时由 SDK 完成鉴权过程
  5. 管理:推荐直接使用控制台进行管理,也可以使用 SDK 提供的管理接口开发自己的控制台

使用向导

  1. 开通服务,创建空间用于文件存储,参考 接入指引
  2. 下载服务端 SDK,导入 Demo 工程,通过 AK、SK 配置签名,参考 Java SDKPHP SDK
  3. 参照上传、下载、管理、鉴权等接口描述,熟悉 Demo,参考Java SDKPHP SDK
  4. 引入 SDK 到目标工程,并根据需要调用相应接口,完成业务逻辑开发

图片处理

顽兔提供了针对图片的缩放、裁剪、格式转换、WebP 压缩、高斯模糊、图文水印等丰富的处理功能。

举例来说,对图片 “http://pic.myapp.com/pic.jpg” 进行长 100 ,宽 100 的缩放,并调整图像质量为原图的 90%,只需在原图 url 后面加上 “@100w100h90Q.jpg”即可。 关于图片处理更多的样式说明,请参考 图片处理

为了在同一空间中复用图片处理样式,可以在控制台中,将图片处理操作和参数保存为样式别名。例如,在空间中指定样式“abc=100w.jpg”(按宽缩略成100,保存成jpg格式),那么对该空间中的图片缩略 url/pic.jpg@100w.jpg,可以使用url/pic.jpg@!abc 来代替。控制台操作路径为:空间管理 -> 某指定空间 -> 图片处理 -> 新建样式,弹出配置对话框如下:

存量文件迁移

亲也许已经发现了,这只可以免费领养的小兔子很酷,因为她可以轻松把您的 App 变得很酷。 可是已有的存量数据怎么办呢?

针对您的存量数据,顽兔提供了 搬家工具 + 镜像存储 的解决方案。开发者可以先通过搬家工具将大量的冷数据迁移到顽兔平台,并将访问地址切换成顽兔的域名。接下来,通过镜像存储功能,将热流量无缝切换到顽兔域名下。这样,通过搬家工具和镜像存储配合使用,可以将您的文件平滑迁移到顽兔。从而轻松拥有顽兔提供的所有功能。

域名绑定

顽兔支持用户将自有域名绑定(CName)到创建空间时分配的域名上。详情参考:域名绑定

状态码

在开发、调试过程中,开发者可以通过返回的状态码进行问题排查。详情参考:状态码

REST API

对于非 Java、PHP 语言的开发者,或者想深入了解顽兔工作原理的开发者,可以参考:REST API

视频处理

顽兔多媒体服务目前仅通过 REST 接口的方式开放了视频转码功能,接口详见 REST API 中的“4、持久化任务”。 这部分功能的 Java 和 PHP SDK 的封装还在进行中,敬请期待。