媒体播放器缓存

maxCacheFileCount

获取所设置的缓存文件数量上限。

Objective-C

- (NSInteger)maxCacheFileCount;

详情

SDK 默认的缓存文件数量上限为 1000。

返回值

• > 0：方法调用成功，返回缓存文件数量的上限。
• < 0：方法调用失败，详见 AgoraMediaPlayerReason。

所属接口类

• AgoraRtcMediaPlayerCacheManagerProtocol

maxCacheFileSize

获取所设置的缓存文件总缓存的上限。

Objective-C

- (NSInteger)maxCacheFileSize;

详情

SDK 默认的缓存文件总缓存上限为 1GB。你可以调用 setMaxCacheFileSize: 方法自定义总缓存大小的上限。

返回值

• > 0：方法调用成功，返回缓存文件的总缓存上限，单位为字节。
• < 0：方法调用失败，详见 AgoraMediaPlayerReason。

所属接口类

• AgoraRtcMediaPlayerCacheManagerProtocol

cacheDir

获取缓存文件的储存路径。

Objective-C

- (NSString *)cacheDir;

详情

如果你在调用该方法前未曾调用 setCacheDir: 方法自定义缓存文件的储存路径，该方法返回的为 SDK 默认的缓存文件储存路径。

返回值

• 方法调用成功时，返回缓存文件的储存路径。
• < 0：方法调用失败，详见 AgoraMediaPlayerReason。

所属接口类

• AgoraRtcMediaPlayerCacheManagerProtocol

cacheFileCount

获取当前已缓存的媒体文件的总数量。

Objective-C

- (NSInteger)cacheFileCount;

返回值

• ≥ 0：方法调用成功，返回当前已缓存的媒体文件的总数量。
• < 0：方法调用失败，详见 AgoraMediaPlayerReason。

所属接口类

• AgoraRtcMediaPlayerCacheManagerProtocol

enableAutoRemoveCache:

设置是否开启自动清除缓存文件功能。

Objective-C

- (int)enableAutoRemoveCache:(BOOL)enable;

详情

开启自动清除缓存文件后，当播放器中缓存的媒体文件超过你设置的文件数量或总缓存大小的上限时，SDK 会自动清除近期最少使用的一个缓存文件。

参数

enable

是否自动清除缓存文件：

• YES：开启自动清除缓存文件功能。
• NO：（默认）关闭自动清除缓存文件功能。

返回值

• 0：方法调用成功。
• < 0：方法调用失败，详见 AgoraMediaPlayerReason。

所属接口类

• AgoraRtcMediaPlayerCacheManagerProtocol

removeAllCaches

删除媒体播放器中所有已缓存的媒体文件。

Objective-C

- (int)removeAllCaches;

详情

信息

该方法不会删除正在播放中的已缓存媒体文件。

返回值

• 0：方法调用成功。
• < 0：方法调用失败，详见 AgoraMediaPlayerReason。

所属接口类

• AgoraRtcMediaPlayerCacheManagerProtocol

removeCacheByUri:

删除指定的已缓存媒体文件。

Objective-C

- (int)removeCacheByUri:(NSString *)uri;

详情

信息

该方法不会删除正在播放中的已缓存媒体文件。

参数

uri

待删除的缓存文件的 URI（Uniform Resource Identifier），可用于标识媒体文件。

返回值

• 0：方法调用成功。
• < 0：方法调用失败，详见 AgoraMediaPlayerReason。

所属接口类

• AgoraRtcMediaPlayerCacheManagerProtocol

removeOldCache

删除媒体播放器中近期最少使用的一个缓存媒体文件。

Objective-C

- (int)removeOldCache;

详情

缓存媒体文件占用过多空间时，你可以调用该方法清理缓存文件。调用该方法后，SDK 会删除最少使用的一个缓存媒体文件。

信息

当你调用此方法删除缓存媒体文件时，当前正在播放的已缓存媒体文件不会被删除。

返回值

• 0：方法调用成功。
• < 0：方法调用失败，详见 AgoraMediaPlayerReason。

所属接口类

• AgoraRtcMediaPlayerCacheManagerProtocol

setCacheDir:

设置待缓存的媒体文件的储存路径。

Objective-C

- (int)setCacheDir:(NSString *)cacheDir;

详情

信息

该方法需在初始化 AgoraRtcEngineKit 之后调用。

参数

cacheDir

缓存文件储存的绝对路径。请确保指定的目录存在且可写。

返回值

• 0：方法调用成功。
• < 0：方法调用失败，详见 AgoraMediaPlayerReason。

所属接口类

• AgoraRtcMediaPlayerCacheManagerProtocol

setMaxCacheFileCount:

设置缓存媒体文件数量的上限。

Objective-C

- (int)setMaxCacheFileCount:(NSInteger)count;

参数

count

可缓存的媒体文件数量的上限，默认值为 1000。

返回值

• 0：方法调用成功。
• < 0：方法调用失败，详见 AgoraMediaPlayerReason。

所属接口类

• AgoraRtcMediaPlayerCacheManagerProtocol

setMaxCacheFileSize:

设置缓存媒体文件的总缓存大小的上限。

Objective-C

- (int)setMaxCacheFileSize:(NSInteger)cacheSize;

参数

cacheSize

缓存媒体文件的总缓存上限，单位为字节。默认为 1 GB。

返回值

• 0：方法调用成功。
• < 0：方法调用失败，详见 AgoraMediaPlayerReason。

所属接口类

• AgoraRtcMediaPlayerCacheManagerProtocol

sharedInstance

获取 AgoraRtcMediaPlayerCacheManagerProtocol 实例。

Objective-C

+ (instancetype)sharedInstance;

返回值

AgoraRtcMediaPlayerCacheManagerProtocol 实例。

AgoraRtcMediaPlayer:cacheStats:

报告当前缓存中的媒体资源的相关信息。

Objective-C

(void)AgoraRtcMediaPlayer:(id<AgoraRtcMediaPlayerProtocol> _Nonnull)playerKit cacheStats:(AgoraMediaPlayerCacheStatistics *_Nonnull)info NS_SWIFT_NAME(AgoraRtcMediaPlayer(_:cacheStats:));

详情

自从

v4.3.0

调用 openWithMediaSource: 方法且设置 enableCache 成员为 YES 后，SDK 会在媒体文件打开后每秒触发一次该回调，报告当前缓存的媒体文件的统计数据。

参数

info

缓存中的媒体资源的相关信息，详见 AgoraMediaPlayerCacheStatistics。

playerKit

AgoraRtcMediaPlayerProtocol 实例。

所属接口类

• AgoraRtcMediaPlayerDelegate