Unity3D ：PlayableGraph

推薦：將NSDT場(chǎng)景編輯器加入你的3D工具鏈

3D工具集：NSDT簡(jiǎn)石數字孿生

PlayableGraph 定義一組綁定到 GameObject 或組件的可播放輸出項。PlayableGraph 還定義一組可播放項及其依賴(lài)關(guān)系。圖 1 提供了一個(gè)示例。

PlayableGraph 負責管理可播放項及其輸出的生命周期。使用 PlayableGraph 可創(chuàng )建、連接和銷(xiāo)毀可播放項。

在圖 1 中，顯示 PlayableGraph 時(shí)，為了緊湊，從圖形節點(diǎn)的名稱(chēng)中移除了“Playable”一詞。例如，名為“AnimationClipPlayable”的節點(diǎn)顯示為“AnimationClip”。

可播放項是一種繼承 IPlayable 接口的 C# 結構體。它用于定義其與其他可播放項的關(guān)系。同樣，可播放項輸出是繼承 IPlayableOutput 接口的 C# 結構體，用于定義 PlayableGraph 的輸出。

圖 2 顯示了最常見(jiàn)的核心可播放項類(lèi)型。圖 3 顯示了核心可播放項輸出類(lèi)型。

The playable core types and playable output types are implemented as C# structs to avoid allocating memory for garbage collection.

“Playable”是所有可播放項的基本類(lèi)型，這意味著(zhù)您總是可以隱式將一個(gè)可播放項轉換為 Playable。相反的情況并不成立，如果將“Playable”顯式轉換為不兼容類(lèi)型，則會(huì )拋出異常。它還定義能在可播放項上執行的所有基本方法。要訪(fǎng)問(wèn)特定于類(lèi)型的方法，您需要將可播放項轉換為相應類(lèi)型。

PlayableOutput 也是如此，它是所有可播放項輸出的基本類(lèi)型，定義了基本方法。

注意：Playable 和 PlayableOutput 未暴露大量方法。但“PlayableExtensions”和“PlayableOutputExtensions”靜態(tài)類(lèi)提供了擴展方法。

所有非抽象可播放項都有一個(gè)公有靜態(tài)方法 Create()，該方法創(chuàng )建相應類(lèi)型的可播放項?！癈reate()”方法始終將 PlayableGraph 作為其第一個(gè)參數，該圖擁有新創(chuàng )建的可播放項。某些類(lèi)型的可播放項可能需要其他參數。非抽象可播放項輸出還會(huì )暴露 Create() 方法。

有效的可播放項輸出應鏈接到可播放項。如果可播放項輸出未鏈接到可播放項，則可播放項輸出不執行任何操作。要將可播放項輸出鏈接到可播放項，請使用 PlayableOutput.SetSourcePlayable() 方法。對于該特定可播放項輸出，鏈接的可播放項充當可播放項樹(shù)的根。

要將兩個(gè)可播放項連接在一起，請使用 PlayableGraph.Connect() 方法。請注意，某些可播放項不能有輸入。

使用 PlayableGraph.Create() 靜態(tài)方法來(lái)創(chuàng )建 PlayableGraph。

使用 PlayableGraph.Play() 方法來(lái)播放 PlayableGraph。

使用 PlayableGraph.Stop() 方法來(lái)停止播放 PlayableGraph。

使用 PlayableGraph.Evaluate() 方法來(lái)評估 PlayableGraph 在特定時(shí)間的狀態(tài)。

使用 PlayableGraph.Destroy() 方法來(lái)手動(dòng)銷(xiāo)毀 PlayableGraph。此方法會(huì )自動(dòng)銷(xiāo)毀 PlayableGraph 創(chuàng )建的所有可播放項和可播放項輸出。必須手動(dòng)調用此銷(xiāo)毀方法來(lái)銷(xiāo)毀 PlayableGraph，否則 Unity 會(huì )發(fā)出一條錯誤消息。