低层级 3D 渲染函数
setTranslation
设置小组件在场景中的 3D 位置 (平移)。以下小组件支持此函数：“模型”、“模型项”、“3D 图像”、“3D 仪表”和“3D 标签”，以及一些追踪器小组件。
|
名称
|
类型
|
说明
|
必需/可选
|
|---|---|---|---|
|
name
|
字符串
|
要定位的小组件的 Studio ID
|
必需
|
|
x
|
数字
|
3D 空间中的 X 坐标 (米)。
|
必需
|
|
y
|
数字
|
3D 空间中的 Y 坐标 (米)。
|
必需
|
|
z
|
数字
|
3D 空间中的 Z 坐标 (米)。
|
必需
|
|
successCallback
|
函数
|
当操作成功完成时调用。
|
可选
|
|
errorCallback
|
函数
|
当操作失败时调用。
|
可选
|
setRotation
使用以度为单位的欧拉角，设置小组件的 3D 旋转。以下小组件支持此函数：“模型”、“模型项”、“3D 图像”、“3D 仪表”和“3D 标签”，以及一些追踪器小组件。
|
名称
|
类型
|
说明
|
必需/可选
|
|---|---|---|---|
|
name
|
字符串
|
要旋转的小组件的 Studio ID。
|
必需
|
|
x
|
数字
|
绕 X 轴旋转 (度)。
|
必需
|
|
y
|
数字
|
绕 Y 轴旋转 (度)。
|
必需
|
|
z
|
数字
|
绕 Z 轴旋转 (度)。
|
必需
|
|
successCallback
|
函数
|
当操作成功完成时调用。
|
可选
|
|
errorCallback
|
函数
|
当操作失败时调用。
|
可选
|
setScale
设置小组件在 3D 空间中的缩放。以下小组件支持此函数：“模型”、“模型项”、“3D 图像”、“3D 仪表”和“3D 标签”，以及一些追踪器小组件。
|
名称
|
类型
|
说明
|
必需/可选
|
|---|---|---|---|
|
name
|
字符串
|
要缩放的小组件的 Studio ID 。
|
必需
|
|
x
|
数字
|
沿 X 轴的比例因子。
|
必需
|
|
y
|
数字
|
沿 Y 轴的比例因子。
|
必需
|
|
z
|
数字
|
沿 Z 轴的比例因子。
|
必需
|
|
successCallback
|
函数
|
当操作成功完成时调用。
|
可选
|
|
errorCallback
|
函数
|
当操作失败时调用。
|
可选
|
 |
使用此函数可均匀或不均匀地缩放场景中的物体。
|
transform
|
名称
|
类型
|
说明
|
必需/可选
|
|---|---|---|---|
|
name
|
字符串
|
要变换的小组件的 Studio ID。
|
必需
|
|
dx
|
数字
|
3D 空间中的 X 位置 (米)。
|
必需
|
|
dy
|
数字
|
3D 空间中的 Y 位置 (米)。
|
必需
|
|
dz
|
数字
|
3D 空间中的 Z 位置 (米)。
|
必需
|
|
drx
|
数字
|
绕 X 轴旋转 (度)。
|
必需
|
|
dry
|
数字
|
绕 Y 轴旋转 (度)。
|
必需
|
|
drz
|
数字
|
绕 Z 轴旋转 (度)。
|
必需
|
|
successCallback
|
函数
|
当操作成功完成时调用。
|
可选
|
|
errorCallback
|
函数
|
当操作失败时调用。
|
可选
|
|
|
此函数相当于一步调用 setTranslation 和 setRotation。
|
setTexture
设置或更新小组件的纹理。纹理源可以是远程 URL 或 base64 编码的图像字符串。
|
名称
|
类型
|
说明
|
必需/可选
|
|---|---|---|---|
|
name
|
字符串
|
将应用纹理的元素的 Studio ID 。
|
必需
|
|
texture
|
字符串
|
URI 或 base64 编码的图像字符串。如果省略，将从小组件中移除所有现有纹理。
|
必需
|
|
successCallback
|
函数
|
当操作成功完成时调用。
|
可选
|
|
errorCallback
|
函数
|
当操作失败时调用。
|
可选
|
|
|
纹理可应用于以下小组件：模型、3D 图像、3D 仪表和 3D 标签。
|
setColor
|
名称
|
类型
|
说明
|
必需/可选
|
|---|---|---|---|
|
name
|
字符串
|
要应用颜色的模型的 Studio ID。
|
必需
|
|
color
|
字符串
|
颜色被指定为 CSS 样式、rgb 或 rgba 值 (例如，rgb(255, 165, 0) 或 rgba(255, 165, 0, 1.0) 代表橙色)。如果省略，则移除当前颜色。
|
必需
|
|
successCallback
|
函数
|
当操作成功完成时调用。
|
可选
|
|
errorCallback
|
函数
|
当操作失败时调用。
|
可选
|
|
|
• 颜色必须以 rgba(r,g,b,a) 或 rgb(r,g,b) 格式的字符串形式提供，其中：
◦ r、g 和 b 是介于 0 和 255 之间的整数
◦ a 是介于 0.0 和 1.0 之间的浮点数 (如果省略，则默认为 1.0)
• 如果颜色字符串无效，则默认回退为完全不透明的黑色 (rgba(0,0,0,1))。
• 如果省略颜色，则将清除先前设置的颜色覆盖，并且将使用默认材料颜色渲染项。
|