IMediaPlayerCacheManager
该类提供管理媒体播放器中缓存媒体文件的方法。
enableAutoRemoveCache
设置是否开启自动清除缓存文件功能。
virtual int enableAutoRemoveCache(bool enable) = 0;
开启自动清除缓存文件后,当播放器中缓存的媒体文件超过你设置的文件数量或总缓存大小的上限时,SDK 会自动清除近期最少使用的一个缓存文件。
参数
- enable
- 是否自动清除缓存文件:
true
:开启自动清除缓存文件功能。false
:(默认)关闭自动清除缓存文件功能。
返回值
- 0:方法调用成功。
- < 0:方法调用失败,详见 MEDIA_PLAYER_ERROR。
getCacheDir
获取缓存文件的储存路径。
virtual int getCacheDir(char* path, int length) = 0;
如果你在调用该方法前未曾调用 setCacheDir 方法自定义缓存文件的储存路径,该方法返回的为 SDK 默认的缓存文件储存路径。
参数
- path
- 输出参数,缓存文件的储存路径。
- length
- 输入参数,缓存文件储存路径字符串的最大长度。根据你在 path 中获得的缓存文件储存路径字符串来填写。
返回值
- 0:方法调用成功。
- < 0:方法调用失败,详见 MEDIA_PLAYER_ERROR。
getCacheFileCount
获取当前已缓存的媒体文件的总数量。
virtual int getCacheFileCount() = 0;
返回值
- ≥ 0:方法调用成功,返回当前已缓存的媒体文件的总数量。
- < 0:方法调用失败,详见 MEDIA_PLAYER_ERROR。
getMaxCacheFileCount
获取所设置的缓存文件数量上限。
virtual int getMaxCacheFileCount() = 0;
SDK 默认的缓存文件数量上限为 1000。
返回值
- > 0:方法调用成功,返回缓存文件数量的上限。
- < 0:方法调用失败,详见 MEDIA_PLAYER_ERROR。
getMaxCacheFileSize
获取所设置的缓存文件总缓存的上限。
virtual int64_t getMaxCacheFileSize() = 0;
SDK 默认的缓存文件总缓存上限为 1GB。你可以调用 setMaxCacheFileSize 方法自定义总缓存大小的上限。
返回值
- > 0:方法调用成功,返回缓存文件的总缓存上限,单位为字节。
- < 0:方法调用失败,详见 MEDIA_PLAYER_ERROR。
removeAllCaches
删除媒体播放器中所有已缓存的媒体文件。
virtual int removeAllCaches() = 0;
注:
该方法不会删除正在播放中的已缓存媒体文件。
返回值
- 0:方法调用成功。
- < 0:方法调用失败,详见 MEDIA_PLAYER_ERROR。
removeCacheByUri
删除指定的已缓存媒体文件。
virtual int removeCacheByUri(const char *uri) = 0;
注:
该方法不会删除正在播放中的已缓存媒体文件。
参数
- uri
- 待删除的缓存文件的 URI(Uniform Resource Identifier),可用于标识媒体文件。
返回值
- 0:方法调用成功。
- < 0:方法调用失败,详见 MEDIA_PLAYER_ERROR。
removeOldCache
删除媒体播放器中近期最少使用的一个缓存媒体文件。
virtual int removeOldCache() = 0;
缓存媒体文件占用过多空间时,你可以调用该方法清理缓存文件。调用该方法后,SDK 会删除最少使用的一个缓存媒体文件。
注:
当你调用此方法删除缓存媒体文件时,当前正在播放的已缓存媒体文件不会被删除。
返回值
- 0:方法调用成功。
- < 0:方法调用失败,详见 MEDIA_PLAYER_ERROR。
setCacheDir
设置待缓存的媒体文件的储存路径。
virtual int setCacheDir(const char *path) = 0;
注:
该方法需在初始化 IRtcEngine 之前调用。
参数
- path
- 缓存文件储存的绝对路径。请确保指定的目录存在且可写。
返回值
- 0:方法调用成功。
- < 0:方法调用失败,详见 MEDIA_PLAYER_ERROR。
setMaxCacheFileCount
设置缓存媒体文件数量的上限。
virtual int setMaxCacheFileCount(int count) = 0;
参数
- count
- 可缓存的媒体文件数量的上限,默认值为 1000。
返回值
- 0:方法调用成功。
- < 0:方法调用失败,详见 MEDIA_PLAYER_ERROR。
setMaxCacheFileSize
设置缓存媒体文件的总缓存大小的上限。
virtual int setMaxCacheFileSize(int64_t cacheSize) = 0;
参数
- cacheSize
- 缓存媒体文件的总缓存上限,单位为字节。默认为 1 GB。
返回值
- 0:方法调用成功。
- < 0:方法调用失败,详见 MEDIA_PLAYER_ERROR。