如何为基于AVMutableComposition的GPUImageMovie实现拖动定位（Seek）功能？

我之前也碰到过一模一样的情况——用AVMutableComposition配合GPUImageMovie做滤镜处理，换用PlayerItem初始化后播放直接空白，排查下来核心问题是合成资产的加载状态和GPUImageMovie与AVPlayer的同步逻辑没处理到位。下面是经过验证的可行方案：

关键解决步骤 #

1. 先确保AVMutableComposition完全加载完成 #

AVMutableComposition是动态合成的资产，不像本地文件Asset能直接拿来用，必须等它的轨道数据加载完成后，再去创建AVPlayerItem：

// 先异步加载合成资产的轨道数据
[self.composition loadValuesAsynchronouslyForKeys:@[@"tracks"] completionHandler:^{
    dispatch_async(dispatch_get_main_queue(), ^{
        NSError *loadError = nil;
        AVKeyValueStatus loadStatus = [self.composition statusOfValueForKey:@"tracks" error:&loadError];
        if (loadStatus == AVKeyValueStatusLoaded) {
            // 加载成功后再初始化整个GPUImage流水线
            [self setupGPUImagePlaybackPipeline];
        } else {
            NSLog(@"合成资产加载失败: %@", loadError);
        }
    });
}];

2. 正确配置GPUImageMovie的初始化与核心属性 #

用PlayerItem初始化GPUImageMovie时，要开启同步编码，并监听视频帧处理就绪的回调，确保GPUImage能及时拿到有效帧数据：

- (void)setupGPUImagePlaybackPipeline {
    self.videoPlayerItem = [[AVPlayerItem alloc] initWithAsset:self.composition];
    self.videoPlayer = [[AVPlayer alloc] initWithPlayerItem:self.videoPlayerItem];
    
    // 初始化GPUImageMovie
    self.gpuMovie = [[GPUImageMovie alloc] initWithPlayerItem:self.videoPlayerItem];
    // 开启同步编码，保证帧处理和Player的时间线完全同步
    self.gpuMovie.enableSynchronizedEncoding = YES;
    
    __weak typeof(self) weakSelf = self;
    // 等待GPUImage准备好处理视频帧后，再连接滤镜和输出视图
    self.gpuMovie.readyForVideoFrameProcessing = ^{
        dispatch_async(dispatch_get_main_queue(), ^{
            // 这里替换成你需要的滤镜
            GPUImageSepiaFilter *sepiaFilter = [[GPUImageSepiaFilter alloc] init];
            [weakSelf.gpuMovie addTarget:sepiaFilter];
            [sepiaFilter addTarget:weakSelf.gpuImageView]; // 你的GPUImageView显示视图
            
            // 手动触发一次帧处理启动
            [weakSelf.gpuMovie startProcessing];
        });
    };
    
    // 监听PlayerItem的时间跳转通知，Seek后同步GPUImage的处理状态
    [[NSNotificationCenter defaultCenter] addObserver:self
                                             selector:@selector(handlePlayerTimeJump:)
                                                 name:AVPlayerItemTimeJumpedNotification
                                               object:self.videoPlayerItem];
}

3. 处理Seek后的同步逻辑 #

当调用seekToTime:后，AVPlayerItem会发送AVPlayerItemTimeJumpedNotification，此时需要让GPUImageMovie重新启动帧处理，避免画面卡住或空白：

- (void)handlePlayerTimeJump:(NSNotification *)notification {
    // 先停止当前的帧处理，再重启
    [self.gpuMovie endProcessing];
    [self.gpuMovie startProcessing];
    // 如果Seek后需要自动播放，确保Player处于播放状态
    [self.videoPlayer play];
}

4. 规范Seek调用方式 #

调用Seek时，建议使用精确到帧的参数，并确保在主线程执行：

- (void)seekToTargetTime:(CMTime)targetTime {
    dispatch_async(dispatch_get_main_queue(), ^{
        // 用精确的时间偏移做Seek，避免时间误差
        [self.videoPlayer seekToTime:targetTime toleranceBefore:kCMTimeZero toleranceAfter:kCMTimeZero];
    });
}

为什么之前的方法会出现空白？ #

• AVMutableComposition需要时间加载轨道数据，直接初始化PlayerItem时资产还未就绪，GPUImageMovie拿不到有效帧；
• GPUImageMovie基于PlayerItem初始化时，依赖readyForVideoFrameProcessing回调启动帧处理，之前的代码没等这个回调就直接播放，导致没有帧数据输出；
• Seek后没有同步GPUImageMovie的处理状态，Player的时间线已经跳转，但GPUImage还停留在旧的帧位置，最终显示空白。

内容的提问来源于stack exchange，提问作者Can Poyrazoğlu