iOS端基于GoogleCast SDK实现本地相册视频投屏的技术咨询

看起来你正在尝试用GoogleCast SDK把iOS本地相册里的视频投送到投屏设备，我来帮你梳理下核心问题和正确的实现方案——你当前的代码里有个关键误区，直接用本地沙盒的file:// URL是不行的，因为投屏设备在局域网另一端，根本访问不到你APP私有沙盒里的文件，这是本地文件投屏的核心卡点！

我把具体的调整步骤和修正后的代码给你理清楚：

一、核心问题拆解 #

你现在的代码直接把file://格式的本地文件URL传给了GoogleCast的媒体信息，但投屏设备和你的iOS设备是两台独立的设备，它没有权限访问你APP沙盒里的私有文件。所以第一步必须把本地文件转换成局域网可访问的HTTP URL，让投屏设备能通过网络获取到这个视频文件。

二、具体实现步骤&代码修正 #

1. 先配置GoogleCast SDK的内置HTTP服务器

GoogleCast SDK自带了轻量HTTP服务器，可以帮你把本地文件转换成局域网可访问的URL，初始化的时候要开启这个功能：

// 在APP启动时初始化CastContext
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    let castOptions = GCKCastOptions(receiverApplicationID: kGCKDefaultMediaReceiverApplicationID)
    // 允许不安全的内容（因为内置服务器用的是HTTP）
    castOptions.allowedInsecureContentHosts = GCKAllowedInsecureContentHosts(["localhost", "你的设备局域网IP"])
    GCKCastContext.setSharedInstanceWith(castOptions)
    // 启用内置HTTP服务器来共享本地文件
    GCKCastContext.sharedInstance().enableDefaultInsecureReceiverHTTPSServer = true
    return true
}

2. 把本地文件URL转换成可共享的HTTP URL

用SDK的工具方法把file:// URL转换成投屏设备能访问的HTTP URL：

// 你的本地相册视频URL
guard let localVideoURL = URL(string: "file:///private/var/mobile/Containers/Data/PluginKitPlugin/CBC411B1-375B-44F1-8183-CD932E37F0F3/tmp/trim.922BBE6C-5C61-4613-B881-3FCF65079885.MOV") else {
    print("无效的本地视频URL")
    return
}

// 生成可被投屏设备访问的共享URL
guard let sharedMediaURL = GCKCastContext.sharedInstance().sharedHTTPClient?.createURLForLocalFile(at: localVideoURL) else {
    print("无法生成共享媒体URL，请检查SDK配置")
    return
}

3. 完善会话连接与媒体加载逻辑

要确保会话连接成功后再加载媒体，避免会话未就绪导致的失败，同时补全你代码里缺失的部分：

// 连接到指定的投屏设备
if let connectedDevice = connectedDevice, let targetDevice = GCKCastContext.sharedInstance().discoveryManager.device(withUniqueID: connectedDevice.uniqueID) {
    GCKCastContext.sharedInstance().sessionManager.startSession(with: targetDevice)
    
    // 构建媒体元数据
    let metadata = GCKMediaMetadata()
    metadata.setString(movieModel?.title ?? "本地相册视频", forKey: kGCKMetadataKeyTitle)
    metadata.setString(movieModel?.desc ?? "来自iOS设备", forKey: kGCKMetadataKeySubtitle)
    if let coverImageURL = URL(string: "https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/images/BigBuckBunny.jpg") {
        metadata.addImage(GCKImage(url: coverImageURL, width: 480, height: 360))
    }
    
    // 构建媒体信息
    let mediaInfoBuilder = GCKMediaInformationBuilder(contentURL: sharedMediaURL)
    mediaInfoBuilder.streamType = GCKMediaStreamTypeBuffered // 本地文件用Buffered类型
    mediaInfoBuilder.contentType = "video/quicktime" // MOV格式的正确MIME类型
    mediaInfoBuilder.metadata = metadata
    let mediaInfo = mediaInfoBuilder.build()
    
    // 等待会话连接成功后加载媒体（最好通过GCKSessionManagerListener监听状态）
    // 这里简化处理，直接在当前会话可用时加载
    if let currentSession = GCKCastContext.sharedInstance().sessionManager.currentCastSession,
       let remoteMediaClient = currentSession.remoteMediaClient {
        remoteMediaClient.loadMedia(mediaInfo, autoplay: true) { status, error in
            if let error = error {
                print("投屏加载失败：\(error.localizedDescription)")
            } else {
                print("本地视频投屏成功！")
            }
        }
    }
}

三、额外注意事项 #

• 必须保证iOS设备和投屏设备处于同一个Wi-Fi局域网下，否则投屏设备无法访问共享的HTTP URL
• 要给APP申请相册访问权限，在Info.plist里添加NSPhotoLibraryUsageDescription字段，描述访问相册的用途
• 不同格式的视频要设置正确的MIME类型：比如MP4用video/mp4，MOV用video/quicktime
• 建议通过GCKSessionManagerListener协议监听会话的连接状态，在session(_:didChange:)回调里处理媒体加载，这样更可靠

备注：内容来源于stack exchange，提问作者Harshad Patel