1. 云图网首页
  2. 技术专区
  3. 编程笔记

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

• 编程笔记

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

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

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

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

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

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

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

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

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

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

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

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

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

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

华为3D建模服务提供的材质生成能力，将操作繁琐的材质生成及渲染过程简化提速，基于AI辅助材质生成，提升三维模型外观创作效率，将技术美术的经验和制作规范，固化为材质预设实例，复用有价值的经验与规范，提升内容制作效率，降低材质制作成本。

材质生成能力

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

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

输入图片文件规格

  • 软硬件要求: 普通RGB手机，不要求RGB-D/LiDAR, 全Android机型
  • 支持类型：混凝土、大理石、岩石、碎石、砖、石膏、黏土、金属、木材、树皮、皮革、织物、漆面、塑料、合成材料、碎石、大地（草地、沙滩等）
  • 输入图像的要求：输入图像分辨率达到1~4K，输入图像中无接缝、无亮斑、阴影、倒影
  • 输出贴图分辨率：1k（10241024px） 2k（20482048px）
  • 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”下载配置文件。

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

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

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

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

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

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

步骤 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”文件。

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

步骤 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”文件。

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

b.在“android > defaultConfig”中新增“resConfigs”，配置需要支持的语种，配置格式如下：

android { 
    defaultConfig { 
        ... 
        resConfigs "en", "zh-rCN", "需要支持的其他语言" 
    } 
}

HMS Core SDK支持的语言列表请参见HMS Core SDK支持的语言。

3、同步工程

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

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

注：如果出现错误，请检查网络连接是否正常，以及检查“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开放鉴权客户端模式。

  • 通过setApiKey方法设置api_key，在应用启动时初始化设置一次即可，无需多次设置。
MaterialGenApplication.getInstance().setApiKey("your api_key");

在AppGallery Connect上注册应用时，会给你的应用分配api_key。

  1. 新建材质生成引擎和材质生成配置器并初始化材质生成引擎。
// 新建材质生成引擎，传入当前context。 
Modeling3dTextureEngine engine = Modeling3dTextureEngine.getInstance(context); 
// 新建材质生成配置器。 
Modeling3dTextureSetting setting = new Modeling3dTextureSetting.Factory() 
// 设置工作模式为AI模式。 
.setTextureMode(Modeling3dTextureConstants.AlgorithmMode.AI) 
.create();
  1. 新建侦听器回调，用于处理材质生成上传结果。
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) { 
        // 预留接口。 
    } 
};
  1. 上传采集图片至云侧。
// 获取材质生成任务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); 
}
  1. 查询云侧材质生成进度。
// 新建材质生成任务处理实例，传入当前context。 
Modeling3dTextureTaskUtils taskUtils = Modeling3dTextureTaskUtils.getInstance(context); 
// 查询材质生成进度。 
Modeling3dTextureQueryResult queryResult = taskUtils.queryTask(taskId);
  1. 新建侦听器回调，用于处理材质生成下载结果。
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) { 
        // 预留接口。 
    } 
};
  1. 下载材质生成贴图。
// 设置下载监听器。 
engine.setTextureDownloadListener(downloadListener); 
// 下载材质贴图，传入任务id和保存路径。 
engine.asyncDownloadTexture(taskId, savePath);
  1. 调用材质生成同步接口，可以实时获取生成贴图。
// 同步接口，传入图片文件路径、保存贴图路径、配置器。 
int result = engine.syncGenerateTexture(filePath, downloadPath, setting);
  1. 删除材质生成任务。
int ret = taskUtils.deleteTask(taskId);

了解更多内容>>

访问华为3D建模服务官网

获取华为3D建模开发指导文档

华为HMS Core官方论坛

华为3D建模开源仓库地址：GitHub、Gitee

解决集成问题请到Stack Overflow

关注我们，第一时间了解 HMS Core 最新技术资讯~

{{o.name}}


{{m.name}}

原创文章，作者：3628473679，如若转载，请注明出处：https://blog.ytso.com/199503.html

赞 (0)
0
上一篇 2021年11月20日
下一篇 2021年11月20日

相关推荐

发表回复

登录后才能评论