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

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

前置設定

新增 Render Texture

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

新增 Video Player

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

新增 Raw Image

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

新增 C# 腳本

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

  1. 拖曳 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 技術,常把技術筆記分享到部落格,偶爾還直接挪用文章來當教材的研究生。

留言板

歡迎提問或分享觀點!