[Unity 教學] Video Player 影音播放 C# 腳本語法範例

2024.09.22 / Unity 引擎 / English

Video Player 是 Unity 的影片播放功能，開發者可以透過 C# 腳本控制影片的播放、停止、暫停、抽換或計時。本文將說明如何以 C# 腳本控制 Video Player，並提供許多常用功能的語法示範。

前置設定

新增 Render Texture

在 Textures 資料夾 右鍵 > Create > Render Texture。
修改 Render Texture 的 Size 為 1920 x 1080。

新增 Video Player

在場景中 右鍵 > Video > Video Player。
拖曳要播放的影片到 Video Clip。
取消勾選 Play On Awake。
拖曳 Render Texture 到 Target Texture。

新增 Raw Image

修改 Game View 的解析度為 1920 x 1080。
在場景中 右鍵 > UI > Raw Image。
點擊 Raw Image 左上角的 Anchor Present。
按住 Alt 點擊 Anchor Present 的 右下角選項，讓 Raw Image 放大至全螢幕。
點擊 Scene View 的 2D，開啟 2D 模式。
拖曳 Render Texture 到 Raw Image 的 Texture。

新增 C# 腳本

在 Scripts 資料夾右鍵 Create > C# Script 新增腳本，取名為 VideoController。

拖曳 VideoController 到 Video Player 之下，到這裡我們已完成所有前置設定。

語法範例

單次播放一部影片

在專案開始執行時播放影片。

using UnityEngine;
using UnityEngine.Video;

public class VideoController : MonoBehaviour
{
    private VideoPlayer _videoPlayer;

    private void Awake() => _videoPlayer = GetComponent<VideoPlayer>();

    private void Start()
    {
        _videoPlayer.Play();
    }
}

循環播放一部影片

在專案開始執行時播放影片，當影片播放完畢時自動重播。

using UnityEngine;
using UnityEngine.Video;

public class VideoController : MonoBehaviour
{
    private VideoPlayer _videoPlayer;

    private void Awake() => _videoPlayer = GetComponent<VideoPlayer>();

    private void Start()
    {
        _videoPlayer.isLooping = true;
        _videoPlayer.Play();
    }
}

單次播放多部影片

在專案開始執行時播放第一部影片，當影片播放完畢時自動播放下一部影片，直到 Clips 內的影片全部播完。

using UnityEngine;
using UnityEngine.Video;

public class VideoController : MonoBehaviour
{
    public VideoClip[] Clips;

    private VideoPlayer _videoPlayer;
    private int _videoIndex;

    private void Awake() => _videoPlayer = GetComponent<VideoPlayer>();

    private void Start()
    {
        _videoIndex = 0;
        _videoPlayer.clip = Clips[0];
        _videoPlayer.loopPointReached += NextVideo;
        _videoPlayer.Play();
    }

    private void NextVideo(VideoPlayer _)
    {
        _videoIndex++;
        if (_videoIndex >= Clips.Length)
        {
            return;
        }

        _videoPlayer.clip = Clips[_videoIndex];
        _videoPlayer.Play();
    }
}

循環播放多部影片

在專案開始執行時播放第一部影片，當影片播放完畢時自動播放下一部影片。如果 Clips 內的影片全部播完時，將從第一部影片重新播放，無限循環。

using UnityEngine;
using UnityEngine.Video;

public class VideoController : MonoBehaviour
{
    public VideoClip[] Clips;

    private VideoPlayer _videoPlayer;
    private int _videoIndex;

    private void Awake() => _videoPlayer = GetComponent<VideoPlayer>();

    private void Start()
    {
        _videoIndex = 0;
        _videoPlayer.clip = Clips[0];
        _videoPlayer.loopPointReached += NextVideo;
        _videoPlayer.Play();
    }

    private void NextVideo(VideoPlayer _)
    {
        _videoIndex++;
        if (_videoIndex >= Clips.Length)
        {
            _videoIndex = 0;
        }

        _videoPlayer.clip = Clips[_videoIndex];
        _videoPlayer.Play();
    }
}

Ted Liou

雲科碩士在讀中，專注於 Unity C#、TouchDesigner 技術，常把技術筆記分享到部落格，偶爾還直接挪用文章來當教材的研究生。