53 lines
2.1 KiB
Markdown
53 lines
2.1 KiB
Markdown
# SharedUI/Media
|
||
媒体通用视图与组件。
|
||
|
||
## WakeVideoPlayer
|
||
一个遵循项目 Theme 风格的 SwiftUI 视频播放组件，基于 `AVKit` 封装。
|
||
|
||
支持：
|
||
- 播放 / 暂停
|
||
- 进度条拖动（支持拖动中不打断播放进度回调）
|
||
- 静音切换
|
||
- 全屏播放（`fullScreenCover`）
|
||
- 自动隐藏控件（播放中 2.5s 无操作自动隐藏）
|
||
- 自动播放与循环播放
|
||
- 自定义填充模式（`videoGravity`）
|
||
|
||
### 用法示例
|
||
```swift
|
||
import SwiftUI
|
||
|
||
struct DemoVideoCard: View {
|
||
var body: some View {
|
||
WakeVideoPlayer(
|
||
url: URL(string: "https://devstreaming-cdn.apple.com/videos/wwdc/2020/10653/4/17B5F5F3-4D9E-4BAE-8E8F-2C3C7A01F3F2/cmaf.m3u8")!,
|
||
autoPlay: false,
|
||
isLooping: true,
|
||
showsControls: true,
|
||
allowFullscreen: true,
|
||
muteInitially: false,
|
||
videoGravity: .resizeAspectFill
|
||
)
|
||
.frame(height: 220)
|
||
.clipShape(RoundedRectangle(cornerRadius: Theme.CornerRadius.large, style: .continuous))
|
||
.shadow(color: Theme.Shadows.cardShadow.color, radius: Theme.Shadows.cardShadow.radius, x: Theme.Shadows.cardShadow.x, y: Theme.Shadows.cardShadow.y)
|
||
.padding()
|
||
}
|
||
}
|
||
```
|
||
|
||
### 初始化参数
|
||
- `url: URL` 必填。视频资源地址，支持网络或本地文件 URL。
|
||
- `autoPlay: Bool = true` 首次出现是否自动播放。
|
||
- `isLooping: Bool = false` 是否循环播放。
|
||
- `showsControls: Bool = true` 是否显示自定义控制层。
|
||
- `allowFullscreen: Bool = true` 是否允许进入全屏播放。
|
||
- `muteInitially: Bool = false` 初始是否静音。
|
||
- `videoGravity: AVLayerVideoGravity = .resizeAspectFill` 视频填充模式，如 `.resizeAspect` / `.resizeAspectFill`。
|
||
|
||
### 注意事项
|
||
- 如果是新加入的文件，确保在 Xcode 中将 `WakeVideoPlayer.swift` 添加到对应 Target，否则无法被编译。
|
||
- 远程流地址需确保允许跨域与 HTTPS，示例使用 Apple 公共 HLS 资源。
|
||
- 如果需要画中画（PiP）、双击快退/快进、手势亮度/音量等高级功能，可在此基础上扩展。
|
||
|