1. 创建模型阵列场景

基于同一组模型或构件，通过指定方位创建阵列场景。

请求方式：POST

请求地址：/api/{databaseKey}/scenes/array

1.1. 请求参数

Headers：

参数名	类型	示例	是否必填	参数含义
Authorization	string	c4570cb9ca324bc8ba7dd9d1967710ea	是	操作的通关令牌

PathParas：

参数名	类型	示例	是否必填	参数含义
databaseKey	string	test	是	数据库key，必传

SearchParas：

参数名	类型	示例	是否必填	参数含义
无参数	NULL	NULL	NULL	NULL

Body

application/json:

{
    "name": "阵列",
    "mesh": {
        "type": "group",
        "children": [
            {
                "type": "model",
                "modelKey": "M157767667407",
                "matrix": [
                    1,0,0,0,
                    0,1,0,0,
                    0,0,1,0,
                    0,0,0,1
                ]
            },
            {
                "type": "model",
                "modelKey": "M157767667407",
                "matrix": [
                    1,0,0,0,
                    0,1,0,0,
                    0,0,1,0,
                    10,10,10,1
                ]
            },
            {
                "type": "components",
                "matrix": [
                    1,0,0,0,
                    0,1,0,0,
                    0,0,1,0,
                    0,0,0,1
                ],
                "componentsKey": [
                    "M157767674083_24"
                ]
            },
            {
                "type": "group",
                "children": [
                    {
                        "type": "component",
                        "componentKey": "M15776083_2465",
                        "matrix": [......
                        ]
                    },
                    {
                        "type": "component",
                        "componentKey": "M15767683_2440",
                        "matrix": [......
                        ]
                    }
                ]
            }
        ]
    },
    "docKey": "012e245f581788970"
}

1.2. 参数说明

参数名	类型	示例	是否必填	参数含义
name	string	阵列	是	名字
type	string	group	是	类型
modelKey	string	M157767667407	是	模型key
matrix	string	[1,0,0,0,0,1,0,0,0,0,1,0,0,0,0,1]	是	矩阵

1.3. 正确返回

{
    "message": "请求处理成功",
    "code": "SUCCESS",
    "data": {
        "remark": "场景正在创建中",
        "key": "M1604894785223",
        "status": "0"
    }
}

1.4. 状态码

状态码	code	message	data	原因
400	BAD_PARAMETER	type（xxx）类型不正确	NULL	当type类型不是group、model、components、component时
400	PARAMETER_REQUIRED	参数（children）不能为空	NULL	当group类型下不包含children时
400	COMPONENT_NOT_FOUND	构件（xxx）不存在	NULL	当component的key不存在时
400	MODEL_NOT_FOUND	模型（xxx）不存在	NULL	当model的key不存在时
400	BIZ_EXCEPTION	modelKey为xxxx的模型几何正在转换中,请稍后再试	NULL	场景中同时包含2.0、3.0几何格式的模型，且几何格式是3.0的模型几何尚在转换中
400	BIZ_EXCEPTION	modelKey为xxxx的模型未开始几何转换,构件几何不存在	NULL	场景中同时包含2.0、3.0几何格式的模型，且几何格式是3.0的模型几何尚未转换
400	BIZ_EXCEPTION	modelKey为xxxx的模型的几何转换失败	NULL	场景中同时包含2.0、3.0几何格式的模型，且几何格式是3.0的模型几何转换失败

1.5. 备注

1、1.0版几何格式的模型或构件与2.0、3.0版几何格式不兼容。

2、此接口DWG图纸不适用。

1.6. 注意事项

1、数据库启用gacl时，有模型关联的BOSF文档编辑权限的用户。

2、数据库未启用gacl时，有数据库访问权限的用户。

3、type类型必须为group、model、components、component其中之一。

4、matrix为节点位置（4*4矩阵，按行转换为数组），平移分量单位为米。

5、生成新场景的长度单位是米，若参数存在其他单位，统一转为m。

6、复制原模型中的几何、材质和纹理数据，构建一个独立的模型。

7、docKey为场景对象对应的BOSF文档key，可选。

8、当场景中同时包含2.0、3.0几何格式模型时，校验3.0几何格式的模型几何转换是否完成

创建模型阵列场景