媒体播放器缓存
- Unity
更新时间不可用
EnableAutoRemoveCache
设置是否开启自动清除缓存文件功能。
public abstract int EnableAutoRemoveCache(bool enable);开启自动清除缓存文件后，当播放器中缓存的媒体文件超过你设置的文件数量或总缓存大小的上限时，SDK 会自动清除近期最少使用的一个缓存文件。
参数
返回值
- 0：方法调用成功。
- < 0：方法调用失败，详见 MEDIA_PLAYER_REASON。
所属接口类
GetCacheDir
获取缓存文件的储存路径。
public abstract int GetCacheDir(out string path, int length);如果你在调用该方法前未曾调用 SetCacheDir 方法自定义缓存文件的储存路径，该方法返回的为 SDK 默认的缓存文件储存路径。
参数
返回值
- 0：方法调用成功。
- < 0：方法调用失败，详见 MEDIA_PLAYER_REASON。
所属接口类
GetCacheFileCount
获取当前已缓存的媒体文件的总数量。
public abstract int GetCacheFileCount();返回值
- ≥ 0：方法调用成功，返回当前已缓存的媒体文件的总数量。
- < 0：方法调用失败，详见 MEDIA_PLAYER_REASON。
所属接口类
GetMaxCacheFileCount
获取所设置的缓存文件数量上限。
public abstract int GetMaxCacheFileCount();SDK 默认的缓存文件数量上限为 1000。
返回值
- > 0：方法调用成功，返回缓存文件数量的上限。
- < 0：方法调用失败，详见 MEDIA_PLAYER_REASON。
所属接口类
GetMaxCacheFileSize
获取所设置的缓存文件总缓存的上限。
public abstract Int64 GetMaxCacheFileSize();SDK 默认的缓存文件总缓存上限为 1GB。你可以调用 SetMaxCacheFileSize 方法自定义总缓存大小的上限。
返回值
- > 0：方法调用成功，返回缓存文件的总缓存上限，单位为字节。
- < 0：方法调用失败，详见 MEDIA_PLAYER_REASON。
所属接口类
RemoveAllCaches
删除媒体播放器中所有已缓存的媒体文件。
public abstract int RemoveAllCaches();注： 该方法不会删除正在播放中的已缓存媒体文件。
返回值
- 0：方法调用成功。
- < 0：方法调用失败，详见 MEDIA_PLAYER_REASON。
所属接口类
RemoveCacheByUri
删除指定的已缓存媒体文件。
public abstract int RemoveCacheByUri(string uri) ;注： 该方法不会删除正在播放中的已缓存媒体文件。
参数
返回值
- 0：方法调用成功。
- < 0：方法调用失败，详见 MEDIA_PLAYER_REASON。
所属接口类
RemoveOldCache
删除媒体播放器中近期最少使用的一个缓存媒体文件。
public abstract int RemoveOldCache();缓存媒体文件占用过多空间时，你可以调用该方法清理缓存文件。调用该方法后，SDK 会删除最少使用的一个缓存媒体文件。
注： 当你调用此方法删除缓存媒体文件时，当前正在播放的已缓存媒体文件不会被删除。
返回值
- 0：方法调用成功。
- < 0：方法调用失败，详见 MEDIA_PLAYER_REASON。
所属接口类
SetCacheDir
设置待缓存的媒体文件的储存路径。
public abstract int SetCacheDir(string path) ;注： 该方法需在初始化 IRtcEngine 之后调用。
参数
返回值
- 0：方法调用成功。
- < 0：方法调用失败，详见 MEDIA_PLAYER_REASON。
所属接口类
SetMaxCacheFileCount
设置缓存媒体文件数量的上限。
public abstract int SetMaxCacheFileCount(int count);参数
返回值
- 0：方法调用成功。
- < 0：方法调用失败，详见 MEDIA_PLAYER_REASON。
所属接口类
SetMaxCacheFileSize
设置缓存媒体文件的总缓存大小的上限。
public abstract int SetMaxCacheFileSize(Int64 cacheSize);参数
返回值
- 0：方法调用成功。
- < 0：方法调用失败，详见 MEDIA_PLAYER_REASON。
所属接口类
OnPlayerCacheStats
报告当前缓存中的媒体资源的相关信息。
public virtual void OnPlayerCacheStats(CacheStatistics stats)
{
}调用 OpenWithMediaSource 方法且设置 enableCache 成员为 true 后，SDK 会在媒体文件打开后每秒触发一次该回调，报告当前缓存的媒体文件的统计数据。
参数
| 参数名 | 描述 |
|---|---|
stats | 缓存中的媒体资源的相关信息，详见 CacheStatistics。 |