# 素材区

<figure><img src="/files/qCRxTTLGEVlogAJGCcMi" alt=""><figcaption></figcaption></figure>

在素材管理区域中，可以查看和上传场景中所需的各种素材类型。

***

## 素材类型

<table><thead><tr><th width="123.46875">素材类型</th><th>场景支持情况</th></tr></thead><tbody><tr><td>模型</td><td>所有场景类型均支持</td></tr><tr><td>AR视频</td><td>所有场景类型均支持</td></tr><tr><td>透明视频</td><td>所有场景类型均支持</td></tr><tr><td>图片</td><td>所有场景类型均支持</td></tr><tr><td>音频</td><td>所有场景类型均支持</td></tr><tr><td>全景图</td><td>3D互动场景支持</td></tr><tr><td>识别图</td><td>支持的场景：<br>1. 云识别/陀螺仪<br>2. 图像AR<br>3. 平面AR<br>4. 漫游AR</td></tr><tr><td>定位图</td><td>1. 地标AR<br>2. 世界AR</td></tr></tbody></table>

***

## 模型

### 模型规范

<https://www.yuque.com/kivicube/manual/3d-model-specs>

### 模型上传

<figure><img src="/files/L3WmYWh8upAoZaOZifhd" alt=""><figcaption></figcaption></figure>

#### 本地上传

使用本地上传的情况：

1. 拥有一个 glb/gltf 模型文件
2. 模型文件本身已经调好材质
3. 模型文件已优化，体积较小 :::

#### 内容编辑器上传

使用内容编辑器上传的情况：

1. 拥有 fbx/obj 模型文件（必须使用内容编辑器上传）
2. 拥有 glb/gltf 模型文件也可使用内容编辑器上传
3. 模型文件尚未调好材质
4. 模型文件较大，需要压缩与优化 :::

***

### 免费模型导入

Kivicube 接入了全球最大的实时 3D 资产平台 —— Sketchfab&#x20;

#### 注册并登录 Sketchfab

<figure><img src="/files/IbnQjSQ476Xr64qFmQMb" alt=""><figcaption></figcaption></figure>

#### 从 Sketchfab 平台导入 Kivicube

<figure><img src="/files/Ec9SxXEyRc8evrfVonPl" alt=""><figcaption></figcaption></figure>

### 模型素材详情

<figure><img src="/files/pWlNSpJefMQln9GjF1MW" alt=""><figcaption></figcaption></figure>

***

## AR视频

### AR视频规范

<https://www.yuque.com/kivicube/manual/ar-video>

### AR视频素材详情

<figure><img src="/files/uZpzjT24xF3pBpwNESbJ" alt=""><figcaption></figcaption></figure>

* AR视频本质上是普通视频，如非透明视频需上传至此分类，否则会出错。
* 播放性能占用较高，建议在保证清晰度的前提下，尽量使用较小分辨率。
* iOS 网页端中无法同时播放多个含音频的视频，如播放无声但检测含音轨，可在制作时去除音轨。
* 自 2024.4.19 起，素材详情中显示【音频】信息。

***

## 透明视频

### 透明视频规范

<https://www.yuque.com/kivicube/manual/alpha-video>

### 透明视频素材详情

<figure><img src="/files/kOO4rNrhfLm6mNPEfhRU" alt=""><figcaption></figcaption></figure>

* Kivicube 的透明视频并非真正透明，而是为真实透明视频添加 Alpha 蒙板。
* 制作了透明视频必须上传至透明视频分类，否则会出错。
* 播放性能占用较高，建议分辨率尽量小。
* iOS 网页端不能同时播放多个含音频的视频，如出现无声情况，请检查音轨并去除。
* 自 2024.4.19 起，素材详情中显示【音频】信息。

***

## 图片 / 音频

### 图片规范

<https://www.yuque.com/kivicube/manual/picture-spec>

### 音频规范

<https://www.yuque.com/kivicube/manual/audio-spec>

***

## 全景图

### 全景图规范

<https://www.yuque.com/kivicube/manual/360-degree-panoram>

### 注意事项

* 目前仅 3D 互动场景支持。

***

## 识别图

### 识别图规范

<https://www.yuque.com/kivicube/manual/marker-spec>

### 注意事项

* 目前仅图像AR、漫游AR、平面AR支持。

***

## 定位图

### 定位图规范

<https://www.yuque.com/kivicube/manual/marker-spec>

### 注意事项

* 目前仅地标AR与世界AR支持。

***

## 公共素材库导入

{% hint style="warning" %}
注意：Kivicube 公共素材均不得用于商业用途。
{% endhint %}

***

## 常见问题

### 素材加载失败

出现如下错误时，请尝试以下解决方案：

* 检查设备网络环境，若正常可刷新重试。
* 若素材不标准，请参考 [素材规范](https://www.kivicube.com/blog/help/#Media-Library)。
* 若仍无法导入，可将素材发送至官方邮箱检查：`abel.qi@kivisense.com`

<figure><img src="/files/fm1IjhW4vSidR64dWLBI" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-en.kivicube.com/manual/scene-editor/su-cai-qu.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.