# 服务开通
本文讲述如何从零开通材质库服务和在端上使用材质库。
首先需要通过AECORE创建应用,申请开通材质库服务权限,待人工审核通过后,可开始集成使用材质库服务。
桌面端软件主要以SDK的方式集成材质库,可详见材质库SDK操作手册;Web端系统可以直接通过调用API使用材质库服务。
1.创建应用
登录AECORE,并创建应用,创建应用后即可获取appkey、appsecret,这是调用服务的秘钥请妥善管理。
● 创建应用
● 填写应用信息
应用名称:应用中文名称,可修改;
应用标识:应用的英文名称,唯一不可变更。
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。