【iOS ARKit】3D 视频

在AR 中播放视频也是一种常见的需求，如在一个展厅中放置的虚拟电视上播放宣传视频，或者在游戏中为营造氛围而设置的虚拟电视视频播放，或者在识别的2D个人名片上播放自我介绍视频，因视频具有静态图像无法比拟的综合信息展示能力，采用视频比单纯使用图像表达上更充分，本节我们将学习如何在AR场景中播放视频。

在 AR场景中播放视频与在普通应用中播放视频有很多相同之处，但也有很多不一样的地方，在RealityKit 中播放视频，也同样使用 AVFoundation 流媒体框架，但需要将视频作为动态的纹理映射到虚拟物体表面，基本流程如图 11-4所示。

使用 AVFoundation 流媒体框架播放视频使用到两个最基本的对象：AVPlayeritem 和AVPlayer。其中 AVPlayerItem 为流媒体资源管理对象，它负责管理视频的基本信息和状态，如视频长度、当前状态、缓存进度等，每一个 AVPlayerItem 对象对应一个视频资源；AVPlayer 为视频播放控制操作对象，控制视频的播放、暂停、还原等。

在理解 RealityKit 播放视频的原理与流程后，就可以编写出视频播放代码，为更好地组织代码，新建一个 VideoPlayController 类管理视频播放相关代码，如下代码所示。

//
//  VideoPlayController.swift
//  ARKitDeamo
//
//  Created by zhaoquan du on 2024/3/22.
//import AVFoundation
import Foundation
import RealityKitpublic class VideoPlayController {private var playing = falseprivate var avPlayer: AVPlayer?private var avPlayerItem: AVPlayerItem?private var avPlayerLooper: AVPlayerLooper?private var videoMaterial: VideoMaterial?public var material: Material? { videoMaterial }private func createAVPlayer(_ named: String, withExtension ext: String) -> AVPlayer? {guard let url = Bundle.main.url(forResource: named, withExtension: ext) else {return nil}let avPlayer = AVPlayer(url: url)return avPlayer}private func createVideoPlayerItem(_ named: String, withExtension ext: String) -> AVPlayerItem? {guard let url = Bundle.main.url(forResource: named, withExtension: ext) else {return nil}let avPlayerItem = AVPlayerItem(asset: AVAsset(url: url))return avPlayerItem}init?(_ named: String, withExtension ext: String, useLooper: Bool = false) {playing = falselet player: AVPlayer?if useLooper {let playerItem = createVideoPlayerItem(named, withExtension: ext)guard let avPlayerItem = playerItem else { return nil }let queuePlayer = AVQueuePlayer()avPlayerLooper = AVPlayerLooper(player: queuePlayer, templateItem: avPlayerItem)self.avPlayerItem = avPlayerItemplayer = queuePlayer} else {player = createAVPlayer(named, withExtension: ext)}avPlayer = playerguard let avPlayer = player else { return nil }avPlayer.actionAtItemEnd = .pauseavPlayer.pause()videoMaterial = VideoMaterial(avPlayer: avPlayer)videoMaterial?.controller.audioInputMode = .spatial//if(avPlayerItem?.status == AVPlayerItem.Status.readyToPlay){}NotificationCenter.default.addObserver(self, selector: #selector(VideoDidReachEndNotificationHandler(_:)), name: NSNotification.Name.AVPlayerItemDidPlayToEndTime, object: avPlayer.currentItem)}public func reset() {guard let avPlayer = self.avPlayer else { return }avPlayer.pause()avPlayer.seek(to: .zero)playing = false}public func sceneUpdate() {guard playing, let avPlayer = avPlayer else { return }if avPlayer.timeControlStatus == .paused {avPlayer.seek(to: .zero)avPlayer.play()}}public func enablePlayPause(_ enable: Bool) {playing = enableguard let avPlayer = self.avPlayer else { return }if playing, avPlayer.timeControlStatus == .paused {avPlayer.play()} else if !playing, avPlayer.timeControlStatus != .paused {avPlayer.pause()}}@objc func VideoDidReachEndNotificationHandler(_ notification:NSNotification){print("播放完了")}deinit {NotificationCenter.default.removeObserver(self)}}

在代码中，首先根据是否需要循环播放可在构造函数中分别使用 AVPlayer 或者AVPlayerLooper 构建视频播放控制器，然后设置视频播放完毕后的状态，最后利用视频资源作为材质创建VideoMaterial 对象。除此之外，在代码中还新建了几个控制视频播放的方法以便调用。

代码中设置了视频播放时音频的播放方式，RealityKit 在播放视频时允许其音频以几种不同的方式播放，音频播放方式由 AudioResource. InputMode 枚举描述，具体如下表所示。

枚举值	描述
nonSpatial	不考虑声源位置与方向，以背景音乐方式播放音频
spatial	3D音效，考虑声源的位置与方向
ambient	只考虑声源的方向，不考虑声源位置，声音音量不会出现随距离变化的特性

在代码中，我们也对视频播放完毕事件进行了处理，需要注意的是，播放视频时的事件处理方式与 RealityKit 中其他事件处理方式有些不一样，播放视频的事件使用了 AVFoundation 中更一般的事件机制，具体支持事件及一般处理方法可参阅AVFoundation 相关资料。

注意⚠️视频播放完毕事件只有在视频以不循环播放类型播放时才会触发，另外，添加的事件监听应当在不需要时移除，如本例中在析构函数中移除。

除了可以播放本地视频资源，AVFoundation 也支持通过 HTTP 或者 HTTPS播放网络流媒体资源，但需要注意的是，网络视频资源加载受网速、网络连接等因素影响，具有不确定性，在视频播放之前，务必先检查当前视频资源的可用性，如代码清单11-4中第49行的注释一样，以防止出现不可预知的问题（播放网络视频资源通常应当先缓冲，确保资源在播放前可用）。

视频加载并转换成视频材质之后，就可以像普通材质一样使用，示例代码如下所示。

//
//  Video3DView.swift
//  ARKitDeamo
//
//  Created by zhaoquan du on 2024/3/26.
//import SwiftUI
import ARKit
import RealityKit
import Combinestruct Video3DView: View {static var arView:ARView!var body: some View {Video3DViewContainer().overlay(VStack{Spacer()HStack{Button(action:{Video3DView.arView.playOrPause()}) {Text("播放/暂停").frame(width:120,height:40).font(.body).foregroundColor(.black).background(Color.white).opacity(0.6)}.offset(y:-30).padding(.bottom, 30)Button(action: {Video3DView.arView.reset()}) {Text("重播").frame(width:120,height:40).font(.body).foregroundColor(.black).background(Color.white).opacity(0.6)}.offset(y:-30).padding(.bottom, 30)}Spacer().frame(height: 40)}).navigationTitle("3D视频").edgesIgnoringSafeArea(.all)}
}
var videoPlayController : VideoPlayController!
struct Video3DViewContainer:UIViewRepresentable {func makeUIView(context: Context) -> some ARView {let arView = ARView(frame: .zero)let config = ARWorldTrackingConfiguration()config.planeDetection = .horizontalVideo3DView.arView = arViewarView.session.run(config)arView.createVideoPlane()return arView}func updateUIView(_ uiView: UIViewType, context: Context) {}}var play = false;
extension ARView{func createVideoPlane(isLoop: Bool = false){videoPlayController  = VideoPlayController("video2", withExtension: "mp4", useLooper:false)guard let vPlayController = videoPlayController,let planeMaterial = videoPlayController.material else {return}let planeAnchor = AnchorEntity(plane:.horizontal)let boxMesh = MeshResource.generatePlane(width: 0.2, height: 0.4, cornerRadius: 0)let boxEntity = ModelEntity(mesh: boxMesh,materials: [planeMaterial])boxEntity.generateCollisionShapes(recursive: false)planeAnchor.addChild(boxEntity)self.scene.addAnchor(planeAnchor)self.installGestures(.all,for:boxEntity)}func playOrPause(){play = !playvideoPlayController.enablePlayPause(play)}func reset(){videoPlayController.reset()videoPlayController.enablePlayPause(true)}}

RealityKit 播放视频的效果如下图所示。

图 11-5 在 RealityKit 中播放视频效果图

通过本节的学习，我们知道了在 RealityKit 中播放视频实际上是使用了动态纹理映射的方式，VideoMaterial 与其他所有的材质类型一样，可以使用到任何物体表面、平面、曲面上，由于目前 RealityKit并不支持Shader，所以我们可以使用视频材质作为替代方案实现诸如发光、闪烁、描边等特效，更简单地使用 VideoMaterial的代码如下所示。

let planeAnchor = AnchorEntity(plane:. horizontal)
let planeMesh = MeshResource. generatePlane(width: 0. 3, height: 0.2, cornerRadius:0)
let asset = AVURIAsset (url: Bundle. main. url (forResource: "video",withExtension: "mp4")! )
let playerItem = AVPlayerIten(asset:asset)
let player = AVPlayer ( )
let planeEntity = ModelEntity(mesh: planeMesh, materials: [VideoMaterial (aPlayer:player) ])
player. replaceCurrentItem(with: playerItem)
player. play()
planeEntity. generateCollisionShapes(recursive: false)
planeAnchor. addChild(planeEntity)
self. scene. addAnchor (planeAnchor)

在进行 AR 体验共享时，视频材质与其他材质一样，可以自动进行同步及播放，无须开发人员进行额外处理，在可播放视频格式类型方面，AVFoundation 支持的视频格式其都支持。

具体代码地址：GitHub - duzhaoquan/ARkitDemo