服务开通

本文讲述如何从零开通云渲染服务。

首先需要通过AECORE创建应用，申请开通云渲染服务权限，待审核通过，即可开通云渲染服务。

1.创建测试应用

登录AECORE，并创建应用，创建应用后即可获取appkey、appsecret，这是调用服务的秘钥请妥善管理。

注意

创建应用前请先注册并登录AECORE。 任何个人和企业可以在AECORE注册成为开发者，如果之前有广联达账号，可以直接登录。公司内部员工请统一使用公司邮箱注册

● 创建应用

● 填写应用信息

应用名称：应用中文名称，可修改；

应用标识：应用的英文名称，唯一不可变更。

2.开通订阅云渲染服务

应用创建后选择并开通云渲染服务，按需申请相应服务scope项的授权。

注意

如果仅申请效果图渲染服务,选择"image"项即可；如果仅申请VR烘焙服务，选择"vrcook"项即可。

3.获取集成云渲染服务的加密token

• 将创建应用时获得的appkey和appsecret，进行base64编码，示例如下

String creds = String.format("%s:%s", appKey, appSecret); // appkey和appsecret之间有一个冒号，拼成字符串，如： appKey:appSecret
String credential = Base64.encode(creds.getBytes("UTF-8"));

• 在shell命令行中向云渲染服务端发起获取token请求，将上面的base64编码放入请求头Authorization中，并在前面加上"Basic "。

curl -X POST "https://apigate.glodon.com/urs/aaa/oauth2/token?type=0" \
-H "Authorization: Basic Q1XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXxOGFmaGI=" \
-H "Content-Type: application/json" \
-d '{"username":"test","password":"1234"}'

::: 说明

1、如果访问VR烘焙服务，请将URL地址中的type参数设置为1。

2、请用实际存在的广联达用户中心账号，替换上述参数中的username和password；如果还没有相应账号，请前往广联达用户中心（https://account.glodon.com/login），注册一个新的账号。

:::

注意

1、Basic后有空格；

2、请使用自己创建的appkey和appsecret生成base64编码替换文中的XXX；

3、如果是在windows平台的CMD命令行中运行，请将上面的shell命令行分隔符""替换成windows CMD分隔符"^"

• 请求返回结果如下

{
"code": 0,
"message": "操作成功",
"token": "fG9E4Ch6qRgDtRtr7SX5OYxCAHu13LSWwDWjUydhUSjtsyCQZvrr5JNz1NQlBiTmSO2waiDFc4O1f64hFnY3mrvPtFBFYXOUb5vqmFn/nHZMmnAVL2ZVtLzt7yPkbav0StPTwGSKITlQP1Lhiv0Ra5bjokxEsuUMvvfWUr++cvM+ap6JkRujvyL7MmNHDK20rBr4EseKNQCU3xoMEXr2gQAXW7mmvqPpdv240qh9KCA=",
"expire": 604799
}

TIP

返回参数中的token是一个加密串，调用其他云渲染服务API时，必须将该token值放入http请求的Authorization头。

4.验证云渲染服务接口

• 接口测试：获取用户提交的渲染任务。
• 访问如下接口：https://apigate.glodon.com/urs/image/Jobs
• 将请求头中的Authorization设置为：bearer xx-xxxx-xxxx-xxxxxxx，其中，xxx请用步骤3）中获取的加密token进行替换。
• 若访问成功，表明集成云渲染服务的环境配置成功，返回结果如下图所示。

5.集成云渲染服务

云渲染服务提供了一套比较完备的渲染任务管理和服务接入认证、鉴权、计费相关（简称：AAA）的API接口，方便您用非常简单灵活的方式集成云渲染服务到您的产品中，为您的产品提供各种形式的真实感渲染服务。