# 視覺特效資產

## 創建視覺特效資產

您可以通過在資產瀏覽器中點擊"Add new/添加新項"來創建新的視覺特效/Visual Effect。系統會提示您為視覺特效資產輸入一個名稱。

<figure><img src="https://content.gitbook.com/content/vmiEoZNjYR9FQabz2WCa/blobs/jQEdAOUO8fIvLTSamWEN/Screenshot%202024-05-13%20at%2020.16.01.png" alt="" width="254"><figcaption></figcaption></figure>

## 在場景中放置視覺特效

創建視覺特效後，您可以像放置其他 3D 模型一樣將它們放入場景和預製體中。在資產瀏覽器中，篩選"Visual Effects/視覺特效"。然後點擊並拖動視覺特效到場景中進行放置。

## 在代碼中使用視覺特效資產

### 使用資產 ID 生成視覺特效角色

You 您可以在代碼中使用資產 ID 來引用視覺特效資產。這將在世界中生成一個視覺特效角色並將其返回給您，以便您可以使用播放`play`,、停止`stop`, 或調整時間尺度`timescale`等方法來控制視覺特效。 &#x20;

```typescript
@Actor()
class Player {
    private vfx = inject(VfxService)

    async onInit() {
        const vfxActor = await this.vfx.createFromAssetId('your-asset-id')
        vfxActor.play()
    }
}
```

### 使用視覺特效參數生成視覺特效角色

為了能夠在 Hology 編輯器中配置要使用的視覺特效，您可以在角色上定義一個參數。這可以使您重複使用相同的角色類，但更改視覺特效資產。

```typescript
@Actor()
class Player {
    @Parameter()
    private vfxParam: VisualEffect 

    async onInit() {
        const vfxActor = await this.vfxParam.create()
        vfxActor.play()
    }
}
```