媒体播放器缓存
- C++
更新时间不可用
enableAutoRemoveCache
设置是否自动删除缓存的媒体文件。
virtual int enableAutoRemoveCache(bool enable) = 0;启用该功能后，如果缓存的媒体文件数量或大小超过设置的限制，SDK 会自动删除最近最少使用的缓存文件。
参数
返回值
- 0：方法调用成功。
- < 0：方法调用失败，详见 MEDIA_PLAYER_REASON。
所属接口类
getCacheDir
获取待缓存媒体文件的存储路径。
virtual int getCacheDir(char* path, int length) = 0;如果在调用该方法前未调用 setCacheDir 设置待缓存媒体文件的存储路径，则该方法返回 SDK 使用的默认存储路径。
参数
返回值
- 0：方法调用成功。
- < 0：方法调用失败，详见 MEDIA_PLAYER_REASON。
所属接口类
getCacheFileCount
获取已缓存的媒体文件数量。
virtual int getCacheFileCount() = 0;返回值
- 方法调用成功，返回已缓存的媒体文件数量。
- < 0：方法调用失败，参见 MEDIA_PLAYER_REASON。
所属接口类
getMaxCacheFileCount
获取可缓存的媒体文件的最大数量。
virtual int getMaxCacheFileCount() = 0;返回值
- 0：方法调用成功。
- < 0：方法调用失败，详见 MEDIA_PLAYER_REASON。
所属接口类
getMaxCacheFileSize
获取缓存媒体文件聚合存储空间的最大大小。
virtual int64_t getMaxCacheFileSize() = 0;你可以调用 setMaxCacheFileSize 方法设置缓存媒体文件聚合存储空间的最大大小，默认值为 1 GB。
返回值
- 方法调用成功，返回缓存媒体文件聚合存储空间的最大大小（单位为字节）。
- < 0：方法调用失败，详见 MEDIA_PLAYER_REASON。
所属接口类
removeAllCaches
删除媒体播放器中所有缓存的媒体文件。
virtual int removeAllCaches() = 0;注： removeAllCaches 不会删除当前正在播放的缓存媒体文件。
返回值
- 0：方法调用成功。
- < 0：方法调用失败，详见 MEDIA_PLAYER_REASON。
所属接口类
removeCacheByUri
删除缓存的媒体文件。
virtual int removeCacheByUri(const char *uri) = 0;注： removeCacheByUri 当前不会删除正在播放的缓存媒体文件。
参数
返回值
- 0：方法调用成功。
- < 0：方法调用失败，详见 MEDIA_PLAYER_REASON。
所属接口类
removeOldCache
删除最少使用的缓存媒体文件。
virtual int removeOldCache() = 0;当缓存文件存储空间即将达到上限时，你可以调用该方法，SDK 会删除最少使用的缓存媒体文件。
注： removeOldCache 不会删除当前正在播放的缓存媒体文件。
返回值
- 0：方法调用成功。
- < 0：方法调用失败，详见 MEDIA_PLAYER_REASON。
所属接口类
setCacheDir
设置要缓存的媒体文件的存储路径。
virtual int setCacheDir(const char *path) = 0;注： 请确保在调用该方法前已初始化 IRtcEngine。
参数
返回值
- 0：方法调用成功。
- < 0：方法调用失败，详见 MEDIA_PLAYER_REASON。
所属接口类
setMaxCacheFileCount
设置可缓存的媒体文件的最大数量。
virtual int setMaxCacheFileCount(int count) = 0;参数
返回值
- 0：方法调用成功。
- < 0：方法调用失败，详见 MEDIA_PLAYER_REASON。
所属接口类
setMaxCacheFileSize
设置缓存媒体文件的聚合存储空间的最大大小。
virtual int setMaxCacheFileSize(int64_t cacheSize) = 0;参数
返回值
- 0：方法调用成功。
- < 0：方法调用失败，详见 MEDIA_PLAYER_REASON。
所属接口类
onPlayerCacheStats
上报正在缓存的媒体文件的统计信息。
virtual void onPlayerCacheStats(const media::base::CacheStatistics& stats)调用 openWithMediaSource 方法并将 enableCache 设置为 true 后，SDK 每秒触发一次该回调，上报正在缓存的媒体文件的统计信息。
参数
| 参数名 | 描述 |
|---|---|
stats | 媒体文件缓存统计信息。详见 CacheStatistics。 |