本文介绍了文档管理场景、图片社交场景和家庭设备场景下产品的使用流程。
前提条件
已创建RAM用户并授予RAM用户AliyunIMMFullAccess权限。具体操作,请参见配置用户权限。
已为RAM用户创建AccessKey。具体操作,请参见创建AccessKey。
说明AccessKey包括AccessKey ID和AccessKey Secret,用于调用API。
已开通智能媒体管理服务。具体操作,请参见开通产品。
已开通对象存储OSS并上传文档到OSS。具体操作,请参见开通OSS。
文档管理场景
使用文档格式转换功能,可以将48种文档格式转换为JPG、PNG、PDF、TXT和VECTOR 5种格式,实现在应用中更好的展示文档。使用步骤如下:
创建项目。
通过智能媒体管理控制台创建项目。
通过同步请求或者异步请求进行文档格式转换。
同步请求需要在5秒的时间内完成文档转换,如果同步请求转换失败,请使用异步请求。
转换成功后,可以在OSS的指定目录查看对应的输出结果。
同步请求
调用ConvertOfficeFormat接口进行格式转换。
异步请求
调用CreateOfficeConversionTask接口进行格式转换。
创建格式转换任务后,您可以通过调用GetOfficeConversionTask接口获取任务状态或者使用消息队列获取转换结果的通知(Notification)。
智能媒体管理提供文档预览V1和文档预览V2两个版本的文档预览,请根据实际场景选择。
如果预览服务的域名和OSS Bucket的域名不同,需要设置OSS Bucket的跨域资源共享,允许预览服务器访问。具体操作,请参见跨域设置。
文档预览V1的使用步骤如下:
创建项目。
通过智能媒体管理控制台创建项目。
通过异步请求进行文档格式转换。
调用CreateOfficeConversionTask接口进行格式转换。
创建格式转换任务后,您可以通过调用GetOfficeConversionTask接口获取任务状态或者使用消息队列获取转换结果的通知(Notification)。
对接预览引擎,将生成到OSS的文件作为参数传递给渲染引擎。
文档预览V2的使用步骤如下:
创建项目。
通过智能媒体管理控制台创建项目。
在服务端分别封装GetOfficePreviewURL和RefreshOfficePreviewToken接口,获取预览地址和AccessToken。
无需指定iframe元素,JS文件会自动在自定块元素下生成iframe,并通过JS文件设置AccessToken即可快捷的实现文档预览。
图片社交分析场景
本场景通常使用图片AI功能,通过调用DetectImageTags接口返回标签信息或者调用DetectImageFaces接口返回人脸信息,然后基于AI处理图片得到的元数据,使用智能媒体管理提供的元数据索引能力,可以帮助您的应用快速构建标签搜索能力,例如在图片社区应用中加入搜索栏,查询具有猫的图片。使用步骤如下:
创建项目。
通过智能媒体管理控制台创建项目。
调用CreateSet接口创建媒体集,并获取媒体集ID(即SetId)。
调用IndexImage接口将图片索引到媒体集中。
当需要索引多张图片时,您可以指定应用多次调用该接口。
调用ListSetTags接口获取媒体集中的标签列表。
调用FindImages接口按指定标签搜索媒体集中的图片。
家庭设备数据存储场景
本场景通常使用图片人脸AI功能,使用您的应用视频截帧生成的多张图片,调用图片人脸聚类功能,实现对家庭成员的识别。使用步骤如下:
创建项目。
通过智能媒体管理控制台创建项目。
调用CreateSet接口创建媒体集,并获取媒体集ID(即SetId)。
调用IndexImage接口将图片索引到媒体集中。
当需要索引多张图片时,您可以指定应用多次调用该接口。
调用CreateGroupFacesJob接口对媒体集中的人脸进行聚类操作。
调用CreateGroupFacesJob接口后,您可以继续调用IndexImage接口将图片中的人脸索引到媒体集,然后再次调用CreateGroupFacesJob接口进行增量聚类的处理。
调用ListFaceGroups接口获取一个媒体集中的人脸分组列表。