大家小时候在玩玩具时肯定都幻想过这样的场景：想象着自己手上的玩具能动起来，就像《玩具总动员》里的玩具们一样有自己的性格，能够和自己一起玩耍。以前我也一直以为玩具总动员只是童话，让玩具拥有灵魂，能够动起来的想法只是幻想。但如今HMS Core 3D建模服务让这一幻想变成了现实。

原理解释

使用HMS Core 3D建模服务骨骼绑定能力就能让玩偶在手机屏幕上动起来，开发者只需要用普通手机拍摄二足人形物体的多张图像，建立静态的3D模型，通过云侧AI自动绑定算法后，自动生成模型的骨骼和蒙皮权重，通过业界主流引擎即可一键驱动。除了预置的动作还能加入自己动捕的个性化动作，让玩偶形象在屏幕上跟着节奏跳舞。

Demo演示

自动骨骼绑定能力开发步骤

在开始开发工作之前，需要先配置AppGallery Connect，同时请确保工程已经集成HMS Core SDK并且已经配置Maven仓地址。

1. 使用云侧服务的能力，需要使用“agconnect-services.json”里的api_key值，在应用初始化时通过api_key或者AccessToken来设置应用鉴权信息，AccessToken的优先级较高。

通过setAccessToken方法设置AccessToken，在应用启动时初始化设置一次即可，无需多次设置。

ReconstructApplication.getInstance().setAccessToken("your AccessToken");

获取Access Token可参见基于OAuth 2.0开放鉴权客户端模式。

通过setApiKey方法设置api_key，在应用启动时初始化设置一次即可，无需多次设置。

ReconstructApplication.getInstance().setApiKey("your api_key");

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

2. 新建3D物体建模引擎并初始化，新建自动骨骼绑定配置器。

// 新建3D物体建模引擎 
Modeling3dReconstructEngine modeling3dReconstructEngine = Modeling3dReconstructEngine.getInstance(context); 
// 新建骨骼绑定蒙皮配置器 
Modeling3dReconstructSetting setting = new Modeling3dReconstructSetting.Factory() 
    // 设置工作模式为图片模式 
    .setReconstructMode(Modeling3dReconstructConstants.ReconstructMode.PICTURE) 
    // 设置任务类型 
    .setTaskType(Modeling3dReconstructConstants.TaskType.AUTO_RIGGING) 
    .create();

3. 新建上传监听器回调，用于处理拍摄的物体图片上传结果

private Modeling3dReconstructUploadListener uploadListener = new Modeling3dReconstructUploadListener() { 
    @Override 
    public void onUploadProgress(String taskId, double progress, Object ext) { 
         // 上传进度 
    } 
    @Override 
    public void onResult(String taskId, Modeling3dReconstructUploadResult result, Object ext) { 
         // 上传成功处理 
    } 
    @Override 
    public void onError(String taskId, int errorCode, String message) { 
        // 上传失败处理 
    } 
};

4. 使用3D物体建模配置器初始化任务，并且给新建的3D物体建模引擎设置上传监听器，上传采集的图片数据。

// 使用3D物体建模配置器初始化任务（该接口需要在子线程中调用） 
Modeling3dReconstructInitResult modeling3dReconstructInitResult = modeling3dReconstructEngine.initTask(setting); 
String taskId = modeling3dReconstructInitResult.getTaskId(); 
// 设置上传监听器 
modeling3dReconstructEngine.setReconstructUploadListener(uploadListener); 
// 调用3D建模引擎的上传接口，上传采集的图片数据 
modeling3dReconstructEngine.uploadFile(taskId, filePath);

5. 查询自动骨骼绑定任务状态

// 查询3D物体建模任务状态需要初始化任务处理类 
Modeling3dReconstructTaskUtils modeling3dReconstructTaskUtils = Modeling3dReconstructTaskUtils.getInstance(context); 
// 调用查询接口获取3D物体建模任务状态（该接口需要在子线程中调用） 
Modeling3dReconstructQueryResult queryResult = modeling3dReconstructTaskUtils.queryTask(taskId); 
// 获取建模任务状态 
int status = queryResult.getStatus();

6. 新建下载监听器回调，用于处理自动骨骼绑定模型文件的下载结果

private Modeling3dReconstructDownloadListener modeling3dReconstructDownloadListener = new Modeling3dReconstructDownloadListener() { 
    @Override 
    public void onDownloadProgress(String taskId, double progress, Object ext) { 
        // 下载进度 
    }     
    @Override 
    public void onResult(String taskId, Modeling3dReconstructDownloadResult result, Object ext) { 
        // 下载成功处理 
    } 
    @Override 
    public void onError(String taskId, int errorCode, String message) { 
        // 下载失败处理 
    } 
};

7. 新建的下载配置项并将新建的下载监听器传入新建的3D物体建模引擎，下载骨骼绑定成功的模型文件

// 设置下载配置项 
Modeling3dReconstructDownloadConfig downloadConfig = new Modeling3dReconstructDownloadConfig.Factory() 
    // 配置OBJ或glTF格式 
    .setModelFormat(Modeling3dReconstructConstants.ModelFormat.OBJ) 
    // 配置普通或PBR模式 
    .setTextureMode(Modeling3dReconstructConstants.TextureMode.PBR) 
    .create(); 
// 设置下载监听器 
modeling3dReconstructEngine.setReconstructDownloadListener(modeling3dReconstructDownloadListener); 
// 调用3D物体建模引擎的下载接口，传入任务ID，下载地址和下载配置项，下载模型文件 
modeling3dReconstructEngine.downloadModelWithConfig(taskId, fileSavePath, downloadConfig);

更多应用场景

使用骨骼绑定功能，除了可以实现让玩偶在手机屏幕上跳舞，还可以帮助开发者做很多其他有趣又强大的功能。如电商领域，使用自动骨骼绑定能力可以驱动手办进行动态展示，从而增加产品的吸引力；在教育领域，可以将骨骼绑定和音频功能结合，让孩子手中的玩偶跳舞讲故事，寓教于乐；在游戏领域，可以将骨骼绑定和AR功能结合，让3D模型走入真实场景中。

了解更多详情>>

访问华为开发者联盟官网
获取开发指导文档
华为移动服务开源仓库地址：GitHub、Gitee

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