如何将Mobile VLCKit媒体连接至Chromecast？求iOS实现示例

前置准备 #

• 通过CocoaPods集成Mobile VLCKit：在Podfile中添加 pod 'MobileVLCKit'，执行 pod install
• 配置Info.plist权限：
  • 添加NSLocalNetworkUsageDescription键，填写本地网络访问用途说明（例如"需要访问本地网络以发现Chromecast设备"）
  • 添加NSBonjourServices数组，包含字符串_googlecast._tcp.，用于发现Chromecast服务

核心实现步骤与代码 #

1. 定义核心属性 #

在播放器ViewController中声明关键实例：

import MobileVLCKit
import GoogleCast

class PlayerViewController: UIViewController {
    // VLC本地播放器实例
    private var vlcPlayer: VLCMediaPlayer!
    // 当前Chromecast会话
    private var castSession: GCKCastSession?
    // Chromecast设备发现管理器
    private var discoveryManager: GCKDiscoveryManager!
    
    // 投屏触发按钮（需在UI中添加）
    @IBOutlet weak var castButton: UIButton!
    
    override func viewDidLoad() {
        super.viewDidLoad()
        setupChromecastDiscovery()
        setupVLCPlayer()
    }
}

2. 初始化Chromecast设备发现 #

private func setupChromecastDiscovery() {
    // 初始化Cast上下文，使用默认媒体接收器
    let options = GCKCastOptions(receiverApplicationID: kGCKDefaultMediaReceiverApplicationID)
    GCKCastContext.setSharedInstanceWith(options)
    
    // 启动设备扫描
    discoveryManager = GCKCastContext.sharedInstance().discoveryManager
    discoveryManager.add(self, delegateQueue: DispatchQueue.main)
    discoveryManager.startDiscovery()
    
    // 监听会话状态变化
    NotificationCenter.default.addObserver(self, selector: #selector(castSessionChanged(_:)), name: .GCKCastSessionManagerDidStartSession, object: nil)
    NotificationCenter.default.addObserver(self, selector: #selector(castSessionChanged(_:)), name: .GCKCastSessionManagerDidEndSession, object: nil)
}

3. 处理设备发现与连接 #

实现GCKDiscoveryManagerDelegate监听设备，并处理连接逻辑：

extension PlayerViewController: GCKDiscoveryManagerDelegate {
    func discoveryManager(_ manager: GCKDiscoveryManager, didDiscover device: GCKDevice) {
        print("发现Chromecast设备: \(device.friendlyName)")
        // 可在此更新UI，展示可选设备列表
    }
    
    @IBAction func castButtonTapped(_ sender: UIButton) {
        guard let targetDevice = discoveryManager.devices.first else {
            print("未检测到Chromecast设备")
            return
        }
        // 发起设备连接
        GCKCastContext.sharedInstance().sessionManager.startSession(with: targetDevice)
    }
}

// 响应会话状态变更
@objc private func castSessionChanged(_ notification: Notification) {
    castSession = GCKCastContext.sharedInstance().sessionManager.currentCastSession
    if castSession != nil {
        castButton.setTitle("断开投屏", for: .normal)
        // 连接成功后切换到投屏播放
        castCurrentMedia()
    } else {
        castButton.setTitle("投屏", for: .normal)
        // 断开后恢复本地播放
        vlcPlayer.play()
    }
}

4. 将VLC媒体投屏到Chromecast #

private func setupVLCPlayer() {
    vlcPlayer = VLCMediaPlayer()
    // 设置本地播放视图（可选）
    vlcPlayer.drawable = self.view
    
    // 加载目标媒体（支持公网URL或局域网可访问地址）
    guard let mediaURL = URL(string: "https://example.com/target-video.mp4") else { return }
    let vlcMedia = VLCMedia(url: mediaURL)
    vlcPlayer.media = vlcMedia
}

private func castCurrentMedia() {
    guard let castSession = castSession, let mediaURL = vlcPlayer.media?.url else { return }
    
    // 构建Chromecast媒体信息
    let mediaInfo = GCKMediaInformation(
        contentID: mediaURL.absoluteString,
        streamType: .buffered,
        contentType: "video/mp4",
        metadata: nil,
        streamDuration: vlcPlayer.media?.duration.int64Value ?? 0
    )
    
    // 加载媒体到投屏设备
    castSession.remoteMediaClient?.loadMedia(mediaInfo, autoplay: true, position: 0, callback: { [weak self] status in
        if status.isSuccess {
            // 投屏加载成功，暂停本地播放
            self?.vlcPlayer.pause()
        } else {
            print("投屏加载失败: \(status.error?.localizedDescription ?? "未知错误")")
        }
    })
}

5. 投屏播放控制 #

添加基础播放控制逻辑：

// 投屏播放
@IBAction func playOnCast(_ sender: UIButton) {
    castSession?.remoteMediaClient?.play()
}

// 投屏暂停
@IBAction func pauseOnCast(_ sender: UIButton) {
    castSession?.remoteMediaClient?.pause()
}

// 调整投屏进度
private func seekToPositionOnCast(seconds: TimeInterval) {
    castSession?.remoteMediaClient?.seek(to: seconds, callback: nil)
}

注意事项 #

• 媒体URL必须是Chromecast可访问的：本地文件需上传至局域网服务器或使用HTTPS公网地址，Chromecast无法直接读取iOS沙箱内文件
• 确保iOS设备与Chromecast处于同一Wi-Fi网络
• 可通过GCKRemoteMediaClientDelegate监听投屏播放状态，实现异常重试或状态同步逻辑

内容的提问来源于stack exchange，提问作者Bruno Pantaleão