服务开通

要使用云材质库，首先要开通材质服务，本文主要说明如何开通材质库服务。

首先需要通过AECORE创建应用，获得应用程序的APPKey和Secret；然后申请开通材质库服务权限，待人工审核通过后，可开始使用材质库服务。

详细操作步骤如下：

1.创建应用

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

::: tip 注意

创建应用前请先注册并登录AECORE。

任何个人和企业可以在AECORE注册成为开发者，如果之前有304永利集团账号，可以直接登录。公司内部员工请统一使用公司邮箱注册

:::

● 创建应用

● 填写应用信息

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

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

2.开通订阅材质库服务

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

也可以在控制台内申请

::: tip 注意

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

:::

3.获取访问服务token

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

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

::: tip 注意

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

:::

4.验证材质库服务

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

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

::: tip 注意

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

:::

5.使用材质管理后台

通过应用开发管理页面，点击下图位置，直接进入材质库管理后台

用户可以查看系统库数据和创建自定义的产品库

上述开通材质库服务是使用材质库的第一步，接下来要把材质库集成到应用系统中。桌面端软件集成材质库，主要以SDK的方式；Web端系统可以通过直接调用API的方式集成材质库。