# 服务开通

本文讲述如何从零开通材质库服务和在端上使用材质库。

首先需要通过AECORE创建应用,申请开通材质库服务权限,待人工审核通过后,可开始集成使用材质库服务。

桌面端软件主要以SDK的方式集成材质库,可详见材质库SDK操作手册;Web端系统可以直接通过调用API使用材质库服务。

1.创建应用

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

注意

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

● 创建应用

● 填写应用信息

应用名称:应用中文名称,可修改;

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

2.开通订阅本服务

应用创建后选择并开通材质库服务,申请应用scope

也可以在控制台内申请

注意

待材质库服务管理员,在后台处理授权完成,才可进行接下来的步骤。需要后台管理员处理授权,请联系图形平台.显示技术开发部.云渲染技术部人员。

3.获取访问服务token

由于AECORE上的服务采用了OAuth2协议的安全保护机制,所以应用在访问服务接口时,需要在请求中带上认证用的access token,后文中所提的token,意指这里的access token

为方便开发者快速体验服务,AECORE提供了在线获取token的快捷方式。请进入应用信息页面,点击“获取应用token”的链接,将自动生成的token并拷贝到系统剪切板中。

注意

OAuth2协议里的access token是有有效期时间限制的,这里通过页面快捷方式获取的token,只作体验使用,在正式应用开发中,请使用应用的AppKey、AppSecret通过用户中心接口获取token,确保获得的token不会过期。

4.验证材质库服务

使用 API Tester (或其他API测试工具)快速验证材质库服务API调用情况。(如图)

  • 打开API Tester界面
  • 在METHOD中选择GET,测试接口为:https://apigate.glodon.com/ggpassets/materiallibrary/go
  • 在HEADER中填写Authorization,并设置内容为:bearer xx-xxxx-xxxx-xxxxxxx (xx-xxxx-xxxx-xxxxxxx 是步骤3中获取的应用token)
  • 点击Send,测试接口,如果返回SUCCESS,表示API接口调动成功,已经成功了开通材质库服务。

注意

当前云材质库里的纹理数据,受版权保护且经过加密。对广联达内部产品,材质数据使用不受限制,但不能直接用于外部非广联达产品。
同样基于数据保密要求,临时测试账号申请token,能够验证接口调用,但可能无法获得实际的材质数据。(如需进一步了解请找服务负责人详细沟通)

5.使用材质库的SDK

详情见材质库SDK说明

6.使用材质服务API

详情见材质库服务API

  • 在线客服

  • 意见反馈