Audio Room

Available in the Industries Circle

Fusion Industries prototyping Addons

音訊房間

在一些案例中，將玩家分成不同的音訊「房間」可能有幫助，這是不論他們之間的距離的。
這意味著如果房間被門隔離，只有在相同的音訊房間的玩家，可以與彼此交談。為了這樣做，我們提供4個類別：

AudioRoomManager
AudioRoom
AudioRoomMember
AudioDoor

音訊房間管理器

AudioRoomManager管理場景中的房間及玩家的清單。

在各個移動之後，由玩家調用MatchingRooms()方法，以取得他所在的房間的清單（請注意，房間可能彼此重疊）。

音訊房間

以AudioRoom元件來定義音訊房間。
由一個中心點及一個方框來設定房間的空間位置（在場景檢視中的一個小方塊顯示它）。
各個AudioRoom有一個特定的Id，並且在Awake()期間在AudioRoomManager上註冊它自己。

IsIsolated布林值用於定義位於房間中的玩家是否被門隔離在其他人之外。
當關聯於房間的門移動時，調用Isolate()方法（由AudioDoor），並且檢查玩家是否位於房間之中，以請他利用OnCurrentRoomIsolationChange()方法來更新音訊群篩選。

音訊房間成員

各個網路玩家預製件有一個AudioRoomMember類別，這樣它可以在開始時在AudioRoomManager上註冊它自己。
在各個移動時，利用DidMove()回調，AudioRoomMember檢查使用者是否已經移動到另一個房間。
然後它根據房間狀態（是否被隔離）來設定音訊群(DynamicAudioGroupMember)。

音訊門

AudioDoor類別必須被新增到一個分隔音訊房間的門遊戲物件。

門可以利用ToogleDoor()及Open()公共方法來開啟與關閉。
如果請求門的開啟與關閉的玩家沒有這個權限來這樣做，那麼他發送一個RPC到狀態授權。

    public void ToogleDoor()
    {
        Open(!IsOpened);
    }

    public void Open(bool isOpen)
    {
        if (Object.HasStateAuthority)
        {
            IsOpened = isOpen;
        }
        else
        {
            RPC_Open(isOpen);
        }
    }

    [Rpc(sources:RpcSources.All, targets: RpcTargets.StateAuthority)]
    public void RPC_Open(bool isOpen)
    {
        IsOpened = isOpen;
    }

門狀態（開啟與關閉）利用已連網布林值IsOpened來透過網路被同步。
一個更改ChangeDetector用於偵測在Render()中的調整

    [Networked]
    public NetworkBool IsOpened { get; set; } = true;

    ChangeDetector renderChangeDetector;

    public override void Spawned()
    {
    base.Spawned();
    OnIsOpenedChange();
    renderChangeDetector = GetChangeDetector(ChangeDetector.Source.SnapshotFrom);
    }

    public override void Render()
    {
        // Check if the IsOpened changed
        if (TryDetectIsOpenedChange())
        {
            OnIsOpenedChange();
        }
    }

OnIsOpenedChange()方法改變由門分隔的房間的隔離狀態。
然後房間告知位於房間中的玩家關於隔離的狀態：如果房間是隔離的，以roomId來設定DynamicAudioGroupMember的additionalGroupFilter。
這樣的話，在房間中的玩家只接聽房間的成員，並且不接聽其他玩家，就算其他玩家位於定義的距離限制之中也不接聽。

當門狀態改變時，生成OnStatusChange()事件。