Unity UGUI的PhysicsRaycaster (物理射線檢測)元件的介紹及使用

1. 什麼是PhysicsRaycaster元件？

PhysicsRaycaster是Unity UGUI中的一個元件，用於在UI元素上進行物理射線檢測。它可以檢測滑鼠或觸控事件是否發生在UI元素上，並將事件傳遞給相應的UI元素。

2. PhysicsRaycaster的工作原理

PhysicsRaycaster通過發射一條射線來檢測UI元素。當射線與UI元素相交時，PhysicsRaycaster會將事件傳遞給相應的UI元素。

3. PhysicsRaycaster的常用屬性

Event Mask：指定哪些層的UI元素可以接收事件。
Max Raycast Distance：指定射線的最大檢測距離。
Blocking Objects：指定哪些型別的物體可以阻擋射線檢測。

4. PhysicsRaycaster的常用函數

Raycast：發射一條射線並返回與之相交的UI元素。

5. 完整例子程式碼

例子1：點選按鈕改變顏色

using UnityEngine;
using UnityEngine.EventSystems;
using UnityEngine.UI;

public class ButtonColorChanger : MonoBehaviour, IPointerClickHandler
{
    private Image image;

    private void Start()
    {
        image = GetComponent<Image>();
    }

    public void OnPointerClick(PointerEventData eventData)
    {
        image.color = Random.ColorHSV();
    }
}

操作步驟：

建立一個Canvas物件，並在Canvas下建立一個Button物件。
將Button物件的Image元件的Color屬性設定為任意顏色。
將Button物件的PhysicsRaycaster元件的Event Mask屬性設定為預設值。
將Button物件的ButtonColorChanger指令碼掛載到Button物件上。
執行遊戲，點選Button物件，顏色會隨機改變。

注意事項：

需要在Canvas物件上新增一個Graphics Raycaster元件，以便PhysicsRaycaster能夠工作。

例子2：拖拽物體

using UnityEngine;
using UnityEngine.EventSystems;

public class ObjectDragger : MonoBehaviour, IPointerDownHandler, IDragHandler
{
    private RectTransform rectTransform;

    private void Start()
    {
        rectTransform = GetComponent<RectTransform>();
    }

    public void OnPointerDown(PointerEventData eventData)
    {
        rectTransform.SetAsLastSibling();
    }

    public void OnDrag(PointerEventData eventData)
    {
        rectTransform.anchoredPosition += eventData.delta;
    }
}

操作步驟：

建立一個Canvas物件，並在Canvas下建立一個Image物件。
將Image物件的PhysicsRaycaster元件的Event Mask屬性設定為預設值。
將Image物件的ObjectDragger指令碼掛載到Image物件上。
執行遊戲，點選Image物件並拖動，Image物件會跟隨滑鼠或觸控移動。

注意事項：

需要在Canvas物件上新增一個Graphics Raycaster元件，以便PhysicsRaycaster能夠工作。

例子3：點選按鈕播放音效

using UnityEngine;
using UnityEngine.EventSystems;
using UnityEngine.UI;

public class ButtonSoundPlayer : MonoBehaviour, IPointerClickHandler
{
    public AudioClip soundClip;

    private Button button;
    private AudioSource audioSource;

    private void Start()
    {
        button = GetComponent<Button>();
        audioSource = GetComponent<AudioSource>();
        audioSource.clip = soundClip;
    }

    public void OnPointerClick(PointerEventData eventData)
    {
        audioSource.Play();
    }
}

操作步驟：

建立一個Canvas物件，並在Canvas下建立一個Button物件。
將Button物件的PhysicsRaycaster元件的Event Mask屬性設定為預設值。
在場景中新增一個AudioSource物件，並將音效檔案拖拽到ButtonSoundPlayer指令碼的soundClip屬性上。
將Button物件的ButtonSoundPlayer指令碼掛載到Button物件上。
執行遊戲，點選Button物件，音效會播放。

注意事項：

需要在Canvas物件上新增一個Graphics Raycaster元件，以便PhysicsRaycaster能夠工作。

例子4：點選按鈕顯示/隱藏物體

using UnityEngine;
using UnityEngine.EventSystems;
using UnityEngine.UI;

public class ButtonObjectToggler : MonoBehaviour, IPointerClickHandler
{
    public GameObject targetObject;

    private Button button;

    private void Start()
    {
        button = GetComponent<Button>();
    }

    public void OnPointerClick(PointerEventData eventData)
    {
        targetObject.SetActive(!targetObject.activeSelf);
    }
}

操作步驟：

建立一個Canvas物件，並在Canvas下建立一個Button物件。
將Button物件的PhysicsRaycaster元件的Event Mask屬性設定為預設值。
在場景中建立一個需要顯示/隱藏的物體，並將該物體拖拽到ButtonObjectToggler指令碼的targetObject屬性上。
將Button物件的ButtonObjectToggler指令碼掛載到Button物件上。
執行遊戲，點選Button物件，物體會顯示或隱藏。

注意事項：

需要在Canvas物件上新增一個Graphics Raycaster元件，以便PhysicsRaycaster能夠工作。

例子5：點選按鈕切換場景

using UnityEngine;
using UnityEngine.EventSystems;
using UnityEngine.SceneManagement;
using UnityEngine.UI;

public class ButtonSceneSwitcher : MonoBehaviour, IPointerClickHandler
{
    public string targetSceneName;

    private Button button;

    private void Start()
    {
        button = GetComponent<Button>();
    }

    public void OnPointerClick(PointerEventData eventData)
    {
        SceneManager.LoadScene(targetSceneName);
    }
}

操作步驟：

建立一個Canvas物件，並在Canvas下建立一個Button物件。
將Button物件的PhysicsRaycaster元件的Event Mask屬性設定為預設值。
在場景中建立一個需要切換到的目標場景，並將目標場景的名稱拖拽到ButtonSceneSwitcher指令碼的targetSceneName屬性上。
將Button物件的ButtonSceneSwitcher指令碼掛載到Button物件上。
執行遊戲，點選Button物件，場景會切換到目標場景。

注意事項：

需要在Canvas物件上新增一個Graphics Raycaster元件，以便PhysicsRaycaster能夠工作。

參考資料

Unity官方檔案：PhysicsRaycaster
Unity官方論壇：PhysicsRaycaster