首页 > 云渲染接入流程

云渲染接入流程

更新时间 : 2020-08-08 09:53:18

接入前期准备工作

需要的开发人员：后端开发人员（不限于Java/PHP/python/Go/NodeJs等），前端JS开发人员或安卓和ios开发人员，AE模板设计师。
在控制台创建并提供必要的信息

设置云存储信息

秘钥管理

获取product_id
[可选]下载JS Demo 进行体验渲染流程

小程序 sdk

H5 sdk
联系商务为您注册的账户提供测试时长，同时商务会与您确定所需的产品类型。
下载云渲染服务端SDK，目前仅提供Java和PHP，如在两种语言之外的接入，请参阅API参考-VE云渲染平台-提交渲染任务文档对接。以下列出与云渲染后端相关接口的文档

提交渲染任务接口参数说明(重要)

如何获取渲染任务状态

任务渲染回调数据格式

状态码列表
在渲染中使用的模板，是需要自行设计制作的，需要设计师阅读相关模板开发文档，依自身需求制作模板。此外，我们还提供了一些模板示例，在后端的SDK的测试用例中也默认包含了模板的下载链接和测试数据

https://www.seeshiontech.com/docs/page_146.html

制作模板

了解标准模板和动态模板的制作过程。注意不可使用我们不支持的AE功能，这会导致渲染失败.
模板设计人员需要与开发人员沟通好，为需要的替换点设计UI-key
模板的导出需要平台提供的导出工具进行导出，具体的使用说明请参照《VE Exporter 动态模板导出教程》

模板管理

使用云渲染平台渲染，客户需要自行管理模板文件；渲染时提供一条下载连接和一串数字版本号给云平台下载模板。云平台会根据模板id+版本号进行模板缓存**如果您后期更新了模板，需要在申请渲染时将版本号递增1，以使云渲染平台自动更新模板缓存。

开发人员使用模板

在使用制作的模板前，开发人员必须了解 引擎素材替换原理
导出模板时必须使用导出工具进行导出，不可以使用使用工程文件进行渲染。
开发人员在拿到模板后，需要从设计师了解到该模板有什么UI-key ，并根据对应的规则编写ReplaceJson
同时开发人员应该阅读《模板素材顺序替换规范》以了解该如何从模板中获取替换点信息。

对接SDK

在接入SDK前，首先需要开发人员和设计师对接完，与设计师沟通过得知了模板有些哪些嵌入点。
开发人员拿到模板后使用SDK解析模板文件夹中的config.json文件，以SDK和config文件生成一个包含数个页面的编辑界面。
后端通过组装前端发送过来的素材以及文字内容，组装成replaceableJson等渲染的数据格式,通过提交渲染任务接口提交到VE云平台进行视频合成

云渲染工作流程

云渲染的流程是您的客户 -> 通过前端SDK -> 提交到后端api -> 组装提交到云渲染api。渲染完成数据异步回调到您预留的后端api上。在ve云渲染中，每次回调的接口都是在提交渲染时通过json内的参数指定，而非在控制台中设置的唯一回调api，这点需要注意。大部分渲染通常需要5秒以上，如果模板非常复杂，使用了很多特效，渲染数分钟的情况也会出现，如需要优化渲染时长，请参考模板渲染速度提升技巧

常见问题排查

Q:替换顺序不对

A: 检查模板config.json包含"ui"字段的元素数量，以及type、ui-key等，确定与传入素材顺序是否相符

Q:模板改了无反应

检查更改模板后，请求渲染时，version字段是否递增。

Q:模板素材替换进去后尺寸不对

检查congfig.json中替换素材默认的尺寸和editSize字段的值是否和传入素材的大小相对应，或检查replaceJson中是否开启了素材自适应。

Q:渲染长时间无反应

如果您是第一次接入，第一次提交渲染，则很有可能是因为oss配置错误，导致视频处于重试上传尝试中。如果以前都是渲染成功的，使用新模板渲染时长时间无回调，则可能是replaceableJson结构与预定结构不符。如果无法排查问题可以联系工作人员查询。

Q:关于常规模板和动态模板的差异

用户通过替换固定数量的素材来合成视频的模板类型叫做标准模板，而用户上传任意数量的素材配合不同风格的视频模板的称为动态模板。

Q:是否可以使用视频做替换素材

可以。

Q:是否可以每个替换元素附带音频

可以，使用渲染请求中的AudioTracks参数进行音轨替换。

Q:如何得知模板有多少个精确替换点

需要和设计师进行确定，或搜索模板congfig.json，查找带有"ui"字段的对象里，有哪些包含ui-key。

Q:是否可以调整视频输出尺寸

调整视频码率可以通过 setBitrateControl参数调整
调整视频分辨率可以通过 outputRatio参数调整

Q:请求渲染接口或请求获取订单状态接口校验失败

检测是否设置utf-8字符集
如果是Python，检测格式化json时格式里不要带空格
检查中文是否会被转为Unicode，是否转移反斜杠

Q:如果处理模板中的精确嵌入点

与设计师提前沟通，得知模板中的精确嵌入点有哪些。