後臺載入

通常，遊戲需要非同步載入資源。當切換遊戲的主場景時（例如，進入新的關卡），您可能想要顯示一個載入畫面，其中包含一些正在進行的指示，或者您可能希望在遊戲過程中載入其他資源。

標準的載入方法（ResourceLoader.load 或 GDScript 中較簡單的 load）會阻塞您的執行緒，導致您的遊戲在載入資源時看起來沒有回應。

其中一種解決方式是使用 ResourceLoader 在背景執行緒中非同步載入資源。

使用 ResourceLoader

通常，你可以使用 ResourceLoader.load_threaded_request 來將指定路徑的資源載入請求排入佇列，這些資源會在背景執行緒中載入。

你可以透過 ResourceLoader.load_threaded_get_status 來檢查狀態。進度可以透過 progress 參數傳入一個陣列變數，該變數會回傳一個包含百分比的單元素陣列。

最後，你可以呼叫 ResourceLoader.load_threaded_get 來取得已載入的資源。

當你呼叫 load_threaded_get() 時，若資源已在背景載入完成，將會立即回傳；否則會像 load() 一樣在這裡阻塞等待載入完成。如果你要保證不會阻塞，請確保從發出載入請求到取用資源之間有足夠時間，或是手動檢查載入狀態。

範例

這個範例展示如何在背景載入一個場景。我們會設計一個按鈕，在按下時產生一個敵人。這個敵人會用 Enemy.tscn，我們會在 _ready 時載入它，並在按下按鈕時實例化。資源路徑為 "Enemy.tscn"，實際位置是 res://Enemy.tscn。

首先，我們會啟動資源載入請求並連接按鈕：

const ENEMY_SCENE_PATH : String = "Enemy.tscn"

func _ready():
    ResourceLoader.load_threaded_request(ENEMY_SCENE_PATH)
    self.pressed.connect(_on_button_pressed)

using Godot;

public partial class MyButton : Button
{
    private const string EnemyScenePath = "Enemy.tscn";

    public override void _Ready()
    {
        ResourceLoader.LoadThreadedRequest(EnemyScenePath);
        Pressed += OnButtonPressed;
    }
}

現在，當按鈕被按下時會呼叫 _on_button_pressed。這個方法將用來產生敵人。

func _on_button_pressed(): # Button was pressed.
    # Obtain the resource now that we need it.
    var enemy_scene = ResourceLoader.load_threaded_get(ENEMY_SCENE_PATH)
    # Instantiate the enemy scene and add it to the current scene.
    var enemy = enemy_scene.instantiate()
    add_child(enemy)

private void OnButtonPressed() // Button was pressed.
{
    // Obtain the resource now that we need it.
    var enemyScene = (PackedScene)ResourceLoader.LoadThreadedGet(EnemyScenePath);
    // Instantiate the enemy scene and add it to the current scene.
    var enemy = enemyScene.Instantiate();
    AddChild(enemy);
}