子件转换集成说明

支持对以下3D零件、装配体进行轻量化转换：

• Solidworks、Catia、Creo、NX 等主流CAD软件的零件、装配体格式。
• STEP、IGS、X_T 等主流中性格式。

子件转换模式下：装配体进行子件转换后，每个子零件会单独生成轻量化文件。支持进行子零件的局部更新，单装配体的预览加载速度会慢于模型转换。适用于 PDM/PLM 等对模型文件版本进行管理、子零件频繁更新的业务系统。

API接口调用

Java SDK接口调用

调用示例：

package com.newdim.demo;
import com.newdim.sdk.YunapiClient;
import com.newdim.sdk.models.*;
import org.json.JSONObject;

public class demo {

    public static void main(String[] args)  {
        //本地插入文件名
        String localFile = "F:\\temp\\model.zip";
        //轻量化文件下载保存路径文件夹
        String saveFile = "F:\\temp\\download";
        //初始化celient partnerID, secretKey,apiServer
        String partnerID = "xx";企业ID
        String secretKey = "xx";密钥
        String apiServer = "https://api.3dopen.cn";接口地址
        YunapiClient yunapiClient = new YunapiClient(partnerID,secretKey,apiServer);
      
        {   
          //单个子件转换任务
            InsertTaskBaseRequest insertTaskRequest = new InsertTaskBaseRequest();
	    InsertTaskResponse res = yunapiClient.InsertPartConverTaskLocalFile(localFile,insertTaskRequest);
            System.out.println(res.taskID);
            if(res.taskID > 0){
                try {
                    //查询任务
                    BaseTaskResponse info = yunapiClient.QueryTask(res.taskID);
                    while (info.getCode() == 1 && info.status < 2){
                        info = yunapiClient.QueryTask(res.taskID);
                        Thread.sleep(2*1000);
                    }
                    if(info.status == 2){ 
                        //下载轻量化数据
                        ResultStatus rs = yunapiClient.DownloadNdsFile(info.outputNdsFiles,saveFile);
                        System.out.println("下载code:"+rs.getCode() + " msg:" + rs.getMsg());
                    }
                }catch (Exception e) {
                    System.out.println("error:"+e.getMessage());
                }
            }
        }
}

C# SDK接口调用

调用示例：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using YunApiSDK;
using YunApiSDK.Model.Request;

namespace YunApiSDKDemo
{
    public class YunApiTest
    {
        /// <summary>
        /// 基础流程
        /// </summary>
        /// <param name="yunapiClient"></param>
        /// <param name="callbackUrl"></param>
        /// <returns></returns>
        public async Task Test()
        {
			string partnerID = "xx";企业ID
			string secretKey = "xx";密钥
			string apiServer = "https://api.3dopen.cn";接口地址
			// 参数分别为门户网站中 开发接口-接口信息 中的企业ID、密钥、接口地址
			var yunapiClient = new YunApiClient(partnerID, secretKey, apiServer);
            var filePath = "F:\\model.zip";
            var fileInfo = new FileInfo(filePath);

            // 获取minio临时上传URL
            var tempUrlRes = await yunapiClient.GetPresignedUploadUrlAsync(new GetPresignedUrlRequest { FileName = fileInfo.Name });

            if (tempUrlRes.Status.Code != 1)
            {
                await Console.Out.WriteLineAsync(tempUrlRes.Status.Msg);
                return;
            }

            // 使用minio临时授权URL上传文件
            var uploadRes = await yunapiClient.UploadFileByNdsFileUrlAsync(tempUrlRes.Data.Url, filePath);

            // 回调接口地址，如果需要回调则配置,不需要则不配置，地址为实际业务中开发的回调接口地址，本例为YunApiSDKCallbackDemo中的测试接口
            // 插入任务
            var insertRes = await yunapiClient.InsertPartConvertAddTaskAsync(new InsertPartConvertAddTaskRequest  { InputNdsFile = tempUrlRes.Data.InputNdsFile, ReturnURL = "" });

            if (insertRes.Status.Code != 1)
            {
                await Console.Out.WriteLineAsync(insertRes.Status.Msg);
                return;
            }

            var taskState = 0;
            var outputDataUrl = string.Empty;
            // 此处使用while循环是为了得到轻量化文件下载地址，演示下载文件，实际情况可根据业务调整
            while (taskState < 2)
            {
                // 查询接口
                var queryRes = await yunapiClient.QueryTaskAsync(new QueryTaskRequest { TaskID = insertRes.Data.TaskID });
                if (queryRes?.Status?.Code != 1)
                {
                    break;
                }
                taskState = queryRes.Data?.Status ?? 5;
                outputDataUrl = queryRes.Data?.OutputNdsFiles;
            }

            // 此段是演示下载轻量化文件，可根据实际情况自行调整
            if (taskState == 2 && !string.IsNullOrEmpty(outputDataUrl))
            {
                var decodeUrl = Encoding.UTF8.GetString(Convert.FromBase64String(outputDataUrl));
                
                // 此处是获取url中的文件名，可根据自己实际业务情况，确定要保存的文件名
                Uri uri = new Uri(decodeUrl);
                string fileName = System.IO.Path.GetFileName(uri.LocalPath);

                // 简单使用，演示功能，最佳实践使用IHttpClientFactory.CreateClient()创建
                var httpClient = new HttpClient();
                using (HttpResponseMessage response = await httpClient.GetAsync(decodeUrl))
                {
                    if (response.IsSuccessStatusCode)
                    {
                        using (var fileStream = await response.Content.ReadAsStreamAsync())
                        using (var outputFileStream = System.IO.File.Create(fileName))
                        {
                            await fileStream.CopyToAsync(outputFileStream);
                        }
                        Console.WriteLine("文件下载成功！");
                    }
                    else
                    {
                        Console.WriteLine("请求失败: " + response.ReasonPhrase);
                    }
                }
            }


        }
    }
}