AVFoundation——AVAsset

一、简介

抽象类用于模拟定时视听媒体，如视频和声音。AVAsset是一个抽象类，所以当你创建一个asset时，实际上是创建了一个名为AVURLAsset的具体子类的实例。

目前还不能用AVAsset子类化处理不受框架支持的流协议或文件格式。

二、api

1、AVAsset

@interface AVAsset : NSObject <NSCopying, AVAsynchronousKeyValueLoading>
// 实例化
+ (instancetype)assetWithURL:(NSURL *)URL;
//asset持续时间
@property (nonatomic, readonly) CMTime duration;
// asset被播放的自然速率（通常是1.0，但不一定)
@property (nonatomic, readonly) float preferredRate;
// asset可听媒体播放的优选音量（通常是1.0，但不一定)
@property (nonatomic, readonly) float preferredVolume;
// 用于表示或处理的asset的可视内容的首选转换。
@property (nonatomic, readonly) CGAffineTransform preferredTransform;
// 已弃用
@property (nonatomic, readonly) CGSize naturalSize NS_DEPRECATED(10_7, 10_8, 4_0, 5_0);

@end


@interface AVAsset (AVAssetAsynchronousLoading)
// 是否提供精确的时间。
@property (nonatomic, readonly) BOOL providesPreciseDurationAndTiming;
// 取消加载
- (void)cancelLoading;
@end


@interface AVAsset (AVAssetReferenceRestrictions)

typedef NS_OPTIONS(NSUInteger, AVAssetReferenceRestrictions) {
    // 表示应遵循所有类型的引用。
    AVAssetReferenceRestrictionForbidNone = 0UL,
    //表示不应该遵循从远程asset（例如通过http URL引用）到本地媒体数据（例如存储在本地文件中）的引用。
    AVAssetReferenceRestrictionForbidRemoteReferenceToLocal = (1UL << 0),
    //表示不应该遵循从本地asset到远程媒体数据的引用。
    AVAssetReferenceRestrictionForbidLocalReferenceToRemote = (1UL << 1),
    // 表示不应遵循从远程asset到存储在其他站点的远程媒体数据的引用。
    AVAssetReferenceRestrictionForbidCrossSiteReference = (1UL << 2),
    // 表示不应该遵循从本地asset到存储在资产的容器文件之外的本地媒体数据的引用
    AVAssetReferenceRestrictionForbidLocalReferenceToLocal = (1UL << 3),
    // 表示只允许引用存储在asset容器文件中的媒体数据。
    AVAssetReferenceRestrictionForbidAll = 0xFFFFUL,
};

// 指示asset在解析对外部媒体数据的引用时所使用的限制，默认是AVAssetReferenceRestrictionForbidNone
@property (nonatomic, readonly) AVAssetReferenceRestrictions referenceRestrictions NS_AVAILABLE(10_7, 5_0);

@end


@interface AVAsset (AVAssetTrackInspection)

/*  包含的AVAssetTrack数组
为asset的媒体轨道提供跟踪级检查接口的对象。 */
@property (nonatomic, readonly) NSArray<AVAssetTrack *> *tracks;
// 提供AVAssetTrack的实例，该实例表示指定的trackID的轨道。
- (nullable AVAssetTrack *)trackWithTrackID:(CMPersistentTrackID)trackID;
// 提供呈现指定媒体类型媒体的asset的AVAssetTracks数组。
- (NSArray<AVAssetTrack *> *)tracksWithMediaType:(AVMediaType)mediaType;
// 提供呈现具有指定特征的媒体的asset的AVAssetTrack数组。
- (NSArray<AVAssetTrack *> *)tracksWithMediaCharacteristic:(AVMediaCharacteristic)mediaCharacteristic;

@property (nonatomic, readonly) NSArray<AVAssetTrackGroup *> *trackGroups NS_AVAILABLE(10_9, 7_0);

@end


@interface AVAsset (AVAssetMetadataReading)

// asset的创建日期
@property (nonatomic, readonly, nullable) AVMetadataItem *creationDate NS_AVAILABLE(10_8, 5_0);
// 资源的歌词(使用适合当前语言环境的语言)。
@property (nonatomic, readonly, nullable) NSString *lyrics;
// 当前视频常见格式类型的元数据
@property (nonatomic, readonly) NSArray<AVMetadataItem *> *commonMetadata;
// 当前视频所有格式类型的元数据
@property (nonatomic, readonly) NSArray<AVMetadataItem *> *metadata NS_AVAILABLE(10_10, 8_0);
// 当前视频所有可用元数据的格式类型元数据的格式类型在AVMetadataFormat中定义了很多种，常见的有title、creator、subject、publisher等
@property (nonatomic, readonly) NSArray<AVMetadataFormat> *availableMetadataFormats;

- (NSArray<AVMetadataItem *> *)metadataForFormat:(AVMetadataFormat)format;

@end


@interface AVAsset (AVAssetChapterInspection)

// 语言环境array
@property (readonly) NSArray<NSLocale *> *availableChapterLocales NS_AVAILABLE(10_7, 4_3);
// 返回具有给定标题语言环境并包含指定键的章节数组。
- (NSArray<AVTimedMetadataGroup *> *)chapterMetadataGroupsWithTitleLocale:(NSLocale *)locale containingItemsWithCommonKeys:(nullable NSArray<AVMetadataKey> *)commonKeys NS_AVAILABLE(10_7, 4_3);
// 返回语言环境与首选语言列表最匹配的章节数组。
- (NSArray<AVTimedMetadataGroup *> *)chapterMetadataGroupsBestMatchingPreferredLanguages:(NSArray<NSString *> *)preferredLanguages NS_AVAILABLE(10_8, 6_0);

@end


@interface AVAsset (AVAssetMediaSelection)

//  提供NSStrings的NSArray，每个NSString指示媒体选择选项可用的媒体特性。
@property (nonatomic, readonly) NSArray<AVMediaCharacteristic> *availableMediaCharacteristicsWithMediaSelectionOptions NS_AVAILABLE(10_8, 5_0);
// 返回包含具有指定媒体特性的一个或多个选项的AVMediaSelectionGroup对象。
- (nullable AVMediaSelectionGroup *)mediaSelectionGroupForMediaCharacteristic:(AVMediaCharacteristic)mediaCharacteristic NS_AVAILABLE(10_8, 5_0);
// 此asset的媒体选择组的默认媒体选择。
@property (nonatomic, readonly) AVMediaSelection *preferredMediaSelection NS_AVAILABLE(10_11, 9_0);
// 为此asset提供AVMediaSelection的所有排列的数组。
@property (nonatomic, readonly) NSArray <AVMediaSelection *> *allMediaSelections NS_AVAILABLE(10_13, 11_0);

@end


@interface AVAsset (AVAssetProtectedContent)
// asset是否具有受保护的内容。
@property (nonatomic, readonly) BOOL hasProtectedContent NS_AVAILABLE(10_7, 4_2);

@end


@interface AVAsset (AVAssetFragments)

// asset是否能够被分段扩展。
@property (nonatomic, readonly) BOOL canContainFragments NS_AVAILABLE(10_11, 9_0);
// asset是否至少扩展了一个片段。
@property (nonatomic, readonly) BOOL containsFragments NS_AVAILABLE(10_11, 9_0);
// 现在或将来可能附加的片段的总持续时间，以便延长asset的持续时间。
@property (nonatomic, readonly) CMTime overallDurationHint NS_AVAILABLE(10_12_2, 10_2);

@end


@interface AVAsset (AVAssetUsability)

// asset或其URL是否可用于初始化AVPlayerItem的实例。
@property (nonatomic, readonly, getter=isPlayable) BOOL playable NS_AVAILABLE(10_7, 4_3);
// 是否可以使用AVAssetExportSession导出asset。
@property (nonatomic, readonly, getter=isExportable) BOOL exportable NS_AVAILABLE(10_7, 4_3);
// 是否可以使用AVAssetReader提取asset的媒体数据。
@property (nonatomic, readonly, getter=isReadable) BOOL readable NS_AVAILABLE(10_7, 4_3);
// 是否可用于AVCompositionTrack对象的片段中。
@property (nonatomic, readonly, getter=isComposable) BOOL composable NS_AVAILABLE(10_7, 4_3);

#if TARGET_OS_IPHONE
// 是否可以将asset写入“已保存的照片”相册。
@property (nonatomic, readonly, getter=isCompatibleWithSavedPhotosAlbum) BOOL compatibleWithSavedPhotosAlbum NS_AVAILABLE_IOS(5_0);

#endif  // TARGET_OS_IPHONE

/*!
  @property     compatibleWithAirPlayVideo
  @abstract     Indicates whether the asset is compatible with AirPlay Video.
  @discussion   YES if an AVPlayerItem initialized with the receiver can be played by an external device via AirPlay Video.
 */
@property (nonatomic, readonly, getter=isCompatibleWithAirPlayVideo) BOOL compatibleWithAirPlayVideo NS_AVAILABLE(10_11, 9_0);

@end

2、AVURLAsset

AVAsset的具体子类，用于从本地或远程URL初始化asset。

@interface AVURLAsset : AVAsset

// 返回AVURLAsset类支持的文件类型的数组。
+ (NSArray<AVFileType> *)audiovisualTypes NS_AVAILABLE(10_7, 5_0);

// 返回AVURLAsset类支持的MIME类型的数组。
+ (NSArray<NSString *> *)audiovisualMIMETypes NS_AVAILABLE(10_7, 5_0);

//如果asset可以使用extendedMIMEType中指定的编解码器和容器类型播放，则为YES，否则为NO。
+ (BOOL)isPlayableExtendedMIMEType: (NSString *)extendedMIMEType NS_AVAILABLE(10_7, 5_0);

+ (instancetype)URLAssetWithURL:(NSURL *)URL options:(nullable NSDictionary<NSString *, id> *)options;
- (instancetype)initWithURL:(NSURL *)URL options:(nullable NSDictionary<NSString *, id> *)options NS_DESIGNATED_INITIALIZER;

@property (nonatomic, readonly, copy) NSURL *URL;

@end


@interface AVURLAsset (AVURLAssetURLHandling)
// 提供对AVAssetResourceLoader实例的访问，该实例对在对asset执行操作（例如回放）过程中可能加载的URL的处理提供有限的控制。
@property (nonatomic, readonly) AVAssetResourceLoader *resourceLoader NS_AVAILABLE(10_9, 6_0);
@end

@interface AVURLAsset (AVAssetCompositionUtility )
// 通过指定的合成轨道可以容纳的内容找到目标的轨道。
- (nullable AVAssetTrack *)compatibleTrackForCompositionTrack:(AVCompositionTrack *)compositionTrack;
@end

初始化的参数options是个字典，它key分别有一下几个：
1、AVURLAssetPreferPreciseDurationAndTimingKey
asset是否应该准备好指示精确的持续时间，并提供按时间进行准确的随机访问。
这个键的值是一个布尔型的NSNumber。

如果传nil或AVURLAssetPreferPreciseDurationAndTimingKey对应的value,则默认为NO。如果该asset仅用于播放,默认值就足够了

2、AVURLAssetReferenceRestrictionsKey
表示解析对外部媒体数据的引用时asset使用的限制。 此键的值是一个包含AVAssetReferenceRestrictions枚举值的NSNumber或多个此类值的逻辑组合。

3、AVURLAssetHTTPCookiesKey
默认情况下，AVURLAsset只能访问适用于AVURLAsset的URL的客户端默认Cookie存储中的Cookie。 你可以通过使用此初始化选项来补充可用于资产的Cookie

4、AVURLAssetAllowsCellularAccessKey
是否允许代表此asset的网络请求使用蜂窝接口。默认yes