本文介绍了文档管理场景、图片社交场景和家庭设备场景下产品的使用流程。

前提条件

  • 已创建RAM用户并授予RAM用户AliyunIMMFullAccess权限。具体操作,请参见配置用户权限
  • 已为RAM用户创建AccessKey。具体操作,请参见为RAM用户创建访问密钥
    说明 AccessKey包括AccessKey ID和AccessKey Secret,用于调用API。
  • 已开通智能媒体管理服务。具体操作,请参见开通产品
  • 已开通对象存储OSS并上传文档到OSS。具体操作,请参见开始使用OSS

文档管理场景

使用文档格式转换功能,可以将48种文档格式转换为JPG、PNG、PDF、TXT和VECTOR 5种格式,实现在应用中更好的展示文档。使用步骤如下:

  1. 创建项目并设置项目类型。
    • 通过智能媒体管理控制台创建项目,并设置项目的类型文档标准型
    • 调用PutProject接口创建项目,并设置Type为DocStarter。
  2. 通过同步请求或者异步请求进行文档格式转换。

    同步请求需要在5秒的时间内完成文档转换,如果同步请求转换失败,请使用异步请求。

    转换成功后,可以在OSS的指定目录查看对应的输出结果。

智能媒体管理提供文档预览V1和文档预览V2两个版本的文档预览,请根据实际场景选择。
注意 如果预览服务的域名和OSS Bucket的域名不同,需要设置OSS Bucket的跨域资源共享,允许预览服务器访问。具体操作,请参见设置跨域资源共享
  • 文档预览V1:将输入文档转换为VECTOR向量格式后,通过对接智能媒体管理提供的前端渲染引擎,实现更易用、功能更强大、定制化的文档预览效果。更多信息,请参见快速入门
    说明 VECTOR格式的文档支持复制文字,缩放不失真,自定义广告等功能。
  • 文档预览V2:获取文档的预览地址和AccessToken后,无需指定iframe元素,JS文件会自动在自定块元素下生成iframe,并通过JS文件设置AccessToken即可快捷的实现文档预览。更多信息,请参见快速入门
文档预览V1的使用步骤如下:
  1. 创建项目并设置项目类型。
    • 通过智能媒体管理控制台创建项目,并设置项目的类型文档标准型
    • 调用PutProject接口创建项目,并设置Type为DocStarter。
  2. 通过异步请求进行文档格式转换。

    调用CreateOfficeConversionTask接口进行格式转换。

    创建格式转换任务后,您可以通过调用GetOfficeConversionTask接口获取任务状态或者使用消息队列获取转换结果的通知(Notification)。

  3. 对接预览引擎,将生成到OSS的文件作为参数传递给渲染引擎。
文档预览V2的使用步骤如下:
  1. 创建项目并设置项目类型。
    • 通过智能媒体管理控制台创建项目,并设置项目的类型文档标准型
    • 调用PutProject接口创建项目,并设置Type为DocStarter。
  2. 在服务端分别封装GetOfficePreviewURLRefreshOfficePreviewToken接口,获取预览地址和AccessToken。
  3. 无需指定iframe元素,JS文件会自动在自定块元素下生成iframe,并通过JS文件设置AccessToken即可快捷的实现文档预览。

图片社交分析场景

本场景通常使用图片AI功能,通过调用DetectImageTags接口返回标签信息或者调用DetectImageFaces接口返回人脸信息,然后基于AI处理图片得到的元数据,使用智能媒体管理提供的元数据索引能力,可以帮助您的应用快速构建标签搜索能力,例如在图片社区应用中加入搜索栏,查询具有猫的图片。使用步骤如下:

  1. 创建项目并设置项目类型。
    • 通过智能媒体管理控制台创建项目,并设置项目的类型图片标准型
    • 调用PutProject接口创建项目,并设置Type为PhotoStarter。
  2. 调用CreateSet接口创建媒体集,并获取媒体集ID(即SetId)。
  3. 调用IndexImage接口将图片索引到媒体集中。

    当需要索引多张图片时,您可以指定应用多次调用该接口。

  4. 调用ListSetTags接口获取媒体集中的标签列表。
  5. 调用FindImages接口按指定标签搜索媒体集中的图片。

家庭设备数据存储场景

本场景通常使用图片人脸AI功能,使用您的应用视频截帧生成的多张图片,调用图片人脸聚类功能,实现对家庭成员的识别。使用步骤如下:

  1. 创建项目并设置项目类型。
    • 通过智能媒体管理控制台创建项目,并设置项目的类型图片标准型
    • 调用PutProject接口创建项目,并设置Type为PhotoStarter。
  2. 调用CreateSet接口创建媒体集,并获取媒体集ID(即SetId)。
  3. 调用IndexImage接口将图片索引到媒体集中。

    当需要索引多张图片时,您可以指定应用多次调用该接口。

  4. 调用CreateGroupFacesJob接口对媒体集中的人脸进行聚类操作。

    调用CreateGroupFacesJob接口后,您可以继续调用IndexImage接口将图片中的人脸索引到媒体集,然后再次调用CreateGroupFacesJob接口进行增量聚类的处理。

  5. 调用ListFaceGroups接口获取一个媒体集中的人脸分组列表。