给3D模型及环境场景渲染出兼具质感和真实感的材质效果，需要经历几步？

显然，目前的3D模型材质渲染技术，还无法实现简单几步就能搞定的标准化作业来量化，完成一个质量过关的3D模型渲染，一般需要：

1、**准备一个内容丰富的贴图、材质库**：渲染想要的材质效果，需要根据具体模型场景的形状细节及复杂程度，针对性收集对应的素材外观和纹理素材，耗时与模型的复杂程度呈正比，并且市面上大部材质付费使用，造价成本高。

2、**从零开始调参**：现有的3D建模工具都要以丰富的参数来实现建模渲染操作，通过调整参数来设置和控制模型。

3、**渲染效果依赖美术经验**：3D建模师逐渐成为紧俏的行业人才，也说明了3D模型制作需要技术和经验老道的从业者，伴随着模型及场景的多样化以及制作的精细化，美术经验直接关系成品质量水准。

传统作业方式确实细活慢工，但逆袭繁琐步骤的材质生成能力已经出现啦！今天给大家带来的**材质生成能力**，简单易用，渲染高质量材质效果，**只需3步！**

以较为常见的3D游戏所需的复杂场景举例，给一个多物体组合的复杂场景渲染材质，只需如下的简单操作：

![](https://oscimg.oschina.net/oscnet/up-dcc06c00afacba19ff5212bf9a463cff657.gif)

1、使用RGB相机拍摄所需材质实物照片。

![](https://oscimg.oschina.net/oscnet/up-cb8395ee349be27e891a32a2b69a722ad31.gif)

2、将RGB照片自动生成材质素材。

![](https://oscimg.oschina.net/oscnet/up-01c209bf35296e922a160572e195ba66a89.gif)

3、材质贴图，完成渲染。

![](https://oscimg.oschina.net/oscnet/up-d1d3cd2054eec5569f264fc02814763f01a.gif)

[华为3D建模服务](https://developer.huawei.com/consumer/cn/hms/huawei-3d-modeling?ha_source=hms1)提供的材质生成能力，将操作繁琐的材质生成及渲染过程简化提速，基于AI辅助材质生成，提升三维模型外观创作效率，将技术美术的经验和制作规范，固化为材质预设实例，复用有价值的经验与规范，提升内容制作效率，降低材质制作成本。

# 材质生成能力
提供将RGB图像转换为PBR材质的能力，用户通过集成SDK，仅需拍摄一张或多张RGB图片，便可一键生成4种材质贴图，包括diffuse map /normal map/specular map/roughness map。AI辅助PBR素材生成，从照片生成材质，解放人力操作成本，满足消费级3D材质应用。

![](https://oscimg.oschina.net/oscnet/up-d77fb618999145ac2d6bc34c8014ad142da.png)

**输入图片文件规格**
* 软硬件要求: 普通RGB手机，不要求RGB-D\LiDAR, 全Android机型
* 支持类型：混凝土、大理石、岩石、碎石、砖、石膏、黏土、金属、木材、树皮、皮革、织物、漆面、塑料、合成材料、碎石、大地（草地、沙滩等）
* 输入图像的要求：输入图像分辨率达到1~4K，输入图像中无接缝、无亮斑、阴影、倒影
* 输出贴图分辨率：1k（1024*1024px） 2k（2048*2048px）
* SDK包大小：88KB
* 准确率：渲染后SSIM>0.9

**应用场景**

3D建模的材质生成能力一键实现现实中各色纹理的木材转化为PBR材质，具有高还原度，极大提高场景的构建效率。简单易用，效果佳，广泛应用于3D内容制作领域。
* **电商行业**：使用3D模型展示商品，为用户提供逼近真实的线上购物体验。
* **展览行业**：高价值的展品及文物，以3D模型形式展示，方便用户细致观览展品细节。
* **游戏行业**：如室内场景里地板、桌子、墙面等所需的木材，打造身临其境的游戏体验。

# 开发准备
## 1、集成HMS Core SDK

**1.1、添加当前应用的AppGallery Connect配置文件**

如果在AppGallery Connect中开通了相关服务则需要将“agconnect-services.json”文件添加到您的App中。

步骤 1：登录AppGallery Connect网站，点击“我的项目”。

步骤 2：在项目列表中找到您的项目，在项目中点击需要集成HMS Core SDK的应用。

步骤 3：在“项目设置 > 常规”页面的“应用”区域，点击“agconnect-services.json”下载配置文件。

![](https://oscimg.oschina.net/oscnet/up-d662dcdd459bdca0bdf84be0696a20da059.png)

步骤 4：将“agconnect-services.json”文件拷贝到应用级根目录下。

![](https://oscimg.oschina.net/oscnet/up-9eb6b1ab9619a326c0d1304c97c4c55140b.png)

**1.2、配置HMS Core SDK的Maven仓地址**

步骤 1：打开Android Studio项目级“build.gradle”文件。

![](https://oscimg.oschina.net/oscnet/up-2b209e83031c729d76cec43a42dc4cbc924.png)

步骤 2：添加HUAWEI agcp插件以及Maven代码库。
* 在“buildscript > repositories”中配置HMS Core SDK的Maven仓地址。
* 在“allprojects > repositories”中配置HMS Core SDK的Maven仓地址。
* 如果App中添加了“agconnect-services.json”文件则需要在“buildscript > dependencies”中增加agcp插件配置。

```
buildscript { 
    repositories { 
        google() 
        jcenter() 
        // 配置HMS Core SDK的Maven仓地址。 
        maven {url 'https://developer.huawei.com/repo/'} 
    } 
    dependencies { 
        ... 
        // 增加agcp插件配置。 
        classpath 'com.huawei.agconnect:agcp:1.4.2.300' 
    } 
} 
 
allprojects { 
    repositories { 
        google() 
        jcenter() 
        // 配置HMS Core SDK的Maven仓地址。 
        maven {url 'https://developer.huawei.com/repo/'} 
    } 
} 
```

注：Maven仓地址无法直接在浏览器中打开访问，只能在IDE中配置。如需添加多个Maven代码库，请将华为公司的Maven仓地址配置在最后。

**1.3、添加编译依赖**

步骤 1：打开应用级的“build.gradle”文件。

![](https://oscimg.oschina.net/oscnet/up-b46724b9dffc04a844d3cb9e033e4e306ea.png)

步骤 2：在“dependencies”中添加如下编译依赖。

* 材质生成

```
dependencies { 
    implementation 'com.huawei.hms:modeling3d-material-generate:{version}' 
}
```

* 3D物体建模

```
dependencies { 
    implementation 'com.huawei.hms:modeling3d-object-reconstruct:{version}' 
}
```

注：{version}替换为实际的Kit依赖版本，版本号索引请参见2 版本更新说明。例如：implementation 'com.huawei.hms:modeling3d-material-generate:1.0.0.300'和implementation 'com.huawei.hms:modeling3d-object-reconstruct:1.0.0.300'。

步骤 3：添加agcp插件配置。请根据实际情况选择：

* 方式一：在文件头部声明下一行添加如下配置。

```
apply plugin: 'com.huawei.agconnect'
```

* 方式二：在plugins中添加如下配置。
```
plugins { 
    id 'com.android.application' 
    // 添加如下配置 
    id 'com.huawei.agconnect' 
}
```

## 2、多语言设置
* 如果您的应用不需要设置只支持某些特定语言，则请忽略本步骤。应用将默认支持所有HMS Core SDK支持的语言。
* 如果您的应用需要设置只支持某些特定语言，则可通过本步骤配置。

a.	打开应用级的“build.gradle”文件。

![](https://oscimg.oschina.net/oscnet/up-89df08a6951aee527ade22544c2f44598cf.png)

b.在“android > defaultConfig”中新增“resConfigs”，配置需要支持的语种，配置格式如下：
```
android { 
    defaultConfig { 
        ... 
        resConfigs "en", "zh-rCN", "需要支持的其他语言" 
    } 
}  
```
HMS Core SDK支持的语言列表请参见HMS Core SDK支持的语言。

## 3、同步工程

在完成以上的配置后，点击工具栏中的gradle同步图标，完成“build.gradle”文件的同步，将相关依赖下载到本地。

![](https://oscimg.oschina.net/oscnet/up-b5832e7f1dc57fd7dfccad61deb752dc474.png)

注：如果出现错误，请检查网络连接是否正常，以及检查“build.gradle”文件是否正确。

## 4、配置混淆脚本
您编译APK前需要配置混淆配置文件，避免混淆HMS Core SDK导致功能异常。

步骤 1：在应用级根目录下打开混淆配置文件“proguard-rules.pro”，加入排除HMS Core SDK的混淆配置脚本。
```
-ignorewarnings 
-keepattributes *Annotation* 
-keepattributes Exceptions 
-keepattributes InnerClasses 
-keepattributes Signature 
-keepattributes SourceFile,LineNumberTable 
-keep class com.huawei.hianalytics.**{*;} 
-keep class com.huawei.updatesdk.**{*;} 
-keep class com.huawei.hms.**{*;}
```

步骤 2：如果您使用了AndResGuard，需要在应用级的“build.gradle”文件中加入AndResGuard允许清单。
```
"R.string.hms*", 
"R.string.connect_server_fail_prompt_toast", 
"R.string.getting_message_fail_prompt_toast", 
"R.string.no_available_network_prompt_toast", 
"R.string.third_app_*", 
"R.string.upsdk_*", 
"R.layout.hms*", 
"R.layout.upsdk_*", 
"R.drawable.upsdk*", 
"R.color.upsdk*", 
"R.dimen.upsdk*", 
"R.style.upsdk*",  
"R.string.agc*"
```

## 5、添加权限
在调用材质生成能力时，开发者需要在AndroidManifest.xml文件中申请如下权限：

```
 
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> 
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> 
 
<uses-permission android:name="android.permission.INTERNET" />
```

在调用3D物体建模能力时，开发者需要在AndroidManifest.xml文件中申请如下权限：
```
  
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />  
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />  
 
<uses-permission android:name="android.permission.INTERNET" /> 
```

# 开发步骤
在开始API开发工作之前，完成开发准备工作同时请确保工程中已经配置配置HMS Core SDK的Maven仓地址，并且完成了本服务的SDK集成。

1.	使用云侧服务的能力，需要使用“agconnect-services.json”里的api_key值，在应用初始化时通过api_key或者AccessToken来设置应用鉴权信息，AccessToken的优先级较高。
* （推荐）通过setAccessToken方法设置AccessToken，在应用启动时初始化设置一次即可，无需多次设置。
```
MaterialGenApplication.getInstance().setAccessToken("your AccessToken");
```
从“ageonnect-services.json”中的api_key获取Access Token可参见[基于OAuth 2.0开放鉴权](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/open-platform-oauth-0000001053629189?ha_source=hms1)客户端模式。

* 通过setApiKey方法设置api_key，在应用启动时初始化设置一次即可，无需多次设置。
```
MaterialGenApplication.getInstance().setApiKey("your api_key");
```
在AppGallery Connect上注册应用时，会给你的应用分配api_key。

2.	新建材质生成引擎和材质生成配置器并初始化材质生成引擎。
```
// 新建材质生成引擎，传入当前context。 
Modeling3dTextureEngine engine = Modeling3dTextureEngine.getInstance(context); 
// 新建材质生成配置器。 
Modeling3dTextureSetting setting = new Modeling3dTextureSetting.Factory() 
// 设置工作模式为AI模式。 
.setTextureMode(Modeling3dTextureConstants.AlgorithmMode.AI) 
.create();
```

3.	新建侦听器回调，用于处理材质生成上传结果。
```
Modeling3dTextureUploadListener uploadListener = new Modeling3dTextureUploadListener() { 
    public void onResult(String taskId, Modeling3dTextureUploadResult result, Object ext) { 
        // 获取材质生成上传图片结果。 
        if (result.isComplete()) { 
            // 上传结果处理。 
        } 
    } 
    @Override 
    public void onError(String taskId, int errorCode, String message) { 
        // 上传错误回调函数。 
    } 
    @Override 
    public void onUploadProgress(String taskId, double progress, Object ext) { 
        // 预留接口。 
    } 
};
```

4.	上传采集图片至云侧。
```
// 获取材质生成任务ID，传入配置器。 
Modeling3dTextureInitResult modeling3dTextureInitResult = engine.initTask(setting); 
String taskId = modeling3dTextureInitResult.getTaskId(); 
if (taskId == null || taskId.equals("")) { 
    Log.e("", "get taskId error " + modeling3dTextureInitResult.getRetMsg()); 
} else { 
    // 设置上传监听器。 
    engine.setTextureUploadListener(uploadListener); 
    // 异步上传，传入任务id和图片文件所在文件夹路径。 
    engine.asyncUploadFile(taskId, filePath); 
}
```

5.	查询云侧材质生成进度。
```
// 新建材质生成任务处理实例，传入当前context。 
Modeling3dTextureTaskUtils taskUtils = Modeling3dTextureTaskUtils.getInstance(context); 
// 查询材质生成进度。 
Modeling3dTextureQueryResult queryResult = taskUtils.queryTask(taskId);
```

6.	新建侦听器回调，用于处理材质生成下载结果。
```
Modeling3dTextureDownloadListener downloadListener = new Modeling3dTextureDownloadListener() { 
    public void onResult(String taskId, Modeling3dTextureDownloadResult result, Object ext) { 
        // 获取材质生成下载贴图结果通知。 
        if (result.isComplete()) { 
            // 下载结果处理。 
        } 
    } 
    @Override 
    public void onError(String taskId, int errorCode, String message) { 
        // 下载错误回调函数。 
    } 
    @Override 
    public void onDownloadProgress(String taskId, double progress, Object ext) { 
        // 预留接口。 
    } 
};
```
7.	下载材质生成贴图。
```
// 设置下载监听器。 
engine.setTextureDownloadListener(downloadListener); 
// 下载材质贴图，传入任务id和保存路径。 
engine.asyncDownloadTexture(taskId, savePath);
```
8.	调用材质生成同步接口，可以实时获取生成贴图。
```
// 同步接口，传入图片文件路径、保存贴图路径、配置器。 
int result = engine.syncGenerateTexture(filePath, downloadPath, setting);
```

9.	删除材质生成任务。
```
int ret = taskUtils.deleteTask(taskId);
```

**了解更多内容>>**
[访问华为3D建模服务官网](https://developer.huawei.com/consumer/cn/hms/huawei-3d-modeling?ha_source=hms1)
[获取华为3D建模开发指导文档](https://developer.huawei.com/consumer/cn/doc/development/graphics-Guides/introduction-0000001143077297?ha_source=hms1)
[华为HMS Core官方论坛](https://developer.huawei.com/consumer/cn/forum/block/hms-core?ha_source=hms1)
华为3D建模开源仓库地址：[GitHub](https://github.com/HMS-Core/hms-3d-modeling-demo)、[Gitee](https://gitee.com/hms-core/hms-3d-modeling-demo)
解决集成问题请到[Stack Overflow](https://stackoverflow.com/questions/tagged/huawei-mobile-services?tab=Newest)
关注我们，第一时间了解 **HMS Core** 最新技术资讯~

ITPub博客

我只用了3步，实现了一个逼真的3D场景渲染

最新文章