---
title: william-weng/wwsimplevideoplayerviewui
framework: Swift Package Catalog
role: article
path: packages/william-weng/wwsimplevideoplayerviewui
---

# william-weng/wwsimplevideoplayerviewui

[English](./README.en.md) | [繁體中文](./README.md)

## 🎬 簡介

- 使用 UIKit 的 `AVPlayerViewController`，直接展示系統內建的播放控制器。 - 背後使用 `AVPlayer` 來播放本地或網路影片。 - 使用 `Binding<URL>` 與 `Binding<Bool>` 接收外部影片來源與是否自動播放。 - 支援在播放過程中更換影片來源，例如切換不同的 .mp4 或 HLS 網址。

## 📦 安裝方式

### Swift Package Manager

```bash swift package add https://github.com/William-Weng/WWSimpleVideoPlayerViewUI.git ```

或在 Xcode 中：

``` File → Add Packages → https://github.com/William-Weng/WWSimpleVideoPlayerViewUI.git ```

## ✨ 功能

- 使用 `UIKit` 播放器整合到 `SwiftUI`，實作完整自訂播放控制。 - 支援播放、暫停、拖曳進度條、音量與亮度手勢調整。 - 可透過 `Binding<WWSimpleVideoPlayerDataSource>` 即時切換影片來源。 - 可透過 `Binding<Bool>` 控制自動播放行為。 - 支援本地檔案與遠端影片來源。

## 🧩 可用參數

| 方法 | 說明 | |---|---| | `source` | 影片來源 URL 的 `Binding`。 | | `isAutoplay` | 是否自動播放的 `Binding`。 | | `configure` | 進度條的`樣式`、`顏色`，以及`縮圖擷取步進`與`縮圖尺寸`等相關配置設定。 |

## 🚀 範例

### 基本播放

```swift import SwiftUI import WWSimpleVideoPlayerViewUI

struct ContentView: View {          private let configure: WWSimpleVideoPlayerConfigure = .init(thumb: Image("thumb"), mainColor: .mint, thumbnailStep: 5.0, thumbnailSize: .init(width: 240, height: 136))          @State var isAutoplay = true     @State var source: ShortVideo = .init(url: .init(string: "https://download.blender.org/peach/bigbuckbunny_movies/BigBuckBunny_320x180.mp4")!)

var body: some View {                  WWSimpleVideoPlayerViewUI<ShortVideo>(source: $source, isAutoplay: $isAutoplay, configure: configure)             .frame(maxWidth: .infinity)     } } ```

## Package Metadata

Repository: william-weng/wwsimplevideoplayerviewui

Default branch: main

README: README.md