prober

探测视频信息与获取视频缩略图功能

功能描述

• 无需启动播放即可得到文件的音视频信息描述，如文件封装格式、视频编码格式、视频宽高、音频编码格式、采样率、声道数等信息
• 获取本地缩略图，可设定输出缩略图的宽高以及所需具体时间点的缩略图

版本要求

• 探测音视频信息: v1.5.3 及以上
• 获取缩略图: v1.8.2 及以上

功能实现

相关功能均有由类KSYMediaInfoProber实现

文件格式探测

@property (nonatomic, strong) KSYMediaInfo *ksyMediaInfo

• 文件格式描述信息定义为KSYMediaInfo
• 支持的封装格式定义为MEDIAINFO_MUX_TYPE
• 支持的音视频格式定义为MEDIAINFO_CODEC_ID
• 支持一个对象进行多次文件探测

NSURL *url = [NSURL URLWithString:@"http://maichang.kssws.ks-cdn.com/upload20150716161913.mp4"];
KSYMediaInfoProber *prober = [[KSYMediaInfoProber alloc] initWithContentURL: url];
KSYMediaInfo *mediaInfo = prober.ksyMediaInfo;
if(mediaInfo)
{
    NSLog(@"mux type:%d", mediaInfo.type);
    NSLog(@"bitrate:%lld", mediaInfo.bitrate);

    for (KSYVideoInfo  *videoInfo in mediaInfo.videos) {
        NSLog(@"video codec:%d", videoInfo.vcodec);
        NSLog(@"video frame width:%d", videoInfo.frame_width);
        NSLog(@"video frame height:%d", videoInfo.frame_height);
    }
        
    for(KSYAudioInfo  *audioInfo in mediaInfo.audios)
    {
        NSLog(@"audio codec:%d", audioInfo.acodec);
        NSLog(@"audio language:%@", audioInfo.language);
        NSLog(@"audio bitrate:%lld", audioInfo.bitrate);
        NSLog(@"audio channels:%d", audioInfo.channels);
        NSLog(@"audio frame_size:%d", audioInfo.framesize);
        NSLog(@"audio sample_format:%d", audioInfo.sample_format);
        NSLog(@"audio samplerate:%d", audioInfo.samplerate);
    }
}

获取缩略图

- (UIImage *)getVideoThumbnailImageAtTime:(NSTimeInterval)seekTime width:(int)width height:(int)height

• seekTime - 指定时间点的视频图像作为缩略图，单位为s

• 该值若小于0，则获取缩略图失败
• 该值等于0时，则以视频首帧为缩略图
• 该值大于0且小于视频总时长时，则会取离该时间点最近的一个关键帧为缩略图
• 该值若大于视频总时长，则以视频首帧为缩略图

• width - 输出缩略图的宽度
• height - 输出缩略图的高度

• 指定缩略图宽度和高度都为0时，输出的缩略图与原视频中的宽高相同
• 指定缩略图宽度不为0，高度为0时，高度会根据原视频的宽高比例做出缩放
• 指定缩略图高度不为0，宽度为0时，宽度会根据原视频的宽高比例作出缩放

注：v1.8.2.0版本要求缩略图的宽高参数必须大于0

NSURL *url = [NSURL URLWithString:@"http://maichang.kssws.ks-cdn.com/upload20150716161913.mp4"];
KSYMediaInfoProber *prober = [[KSYMediaInfoProber alloc] initWithContentURL: url];
UIImage *thumbnailImage = [prober getVideoThumbnailImageAtTime:0 width:640 height:480];