媒体播放器缓存

  • C#

更新时间不可用

EnableAutoRemoveCache

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

C#
public abstract int EnableAutoRemoveCache(bool enable);

详情

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

参数

参数名描述
enable

是否自动清除缓存文件:

  • true:开启自动清除缓存文件功能。
  • false:(默认)关闭自动清除缓存文件功能。
表格内容超出当前宽度,可横向滚动查看更多列。

返回值

所属接口类

GetCacheDir

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

C#
public abstract int GetCacheDir(out string path, int length);

详情

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

参数

参数名描述
path

输出参数,缓存文件的储存路径。

length

输入参数,缓存文件储存路径字符串的最大长度。根据你在 path 中获得的缓存文件储存路径字符串来填写。

表格内容超出当前宽度,可横向滚动查看更多列。

返回值

所属接口类

GetCacheFileCount

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

C#
public abstract int GetCacheFileCount();

返回值

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

所属接口类

GetMaxCacheFileCount

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

C#
public abstract int GetMaxCacheFileCount();

详情

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

返回值

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

所属接口类

GetMaxCacheFileSize

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

C#
public abstract Int64 GetMaxCacheFileSize();

详情

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

返回值

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

所属接口类

RemoveAllCaches

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

C#
 public abstract int RemoveAllCaches();

详情

注:

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

返回值

所属接口类

RemoveCacheByUri

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

C#
public abstract int RemoveCacheByUri(string uri) ;

详情

注:

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

参数

参数名描述
uri

待删除的缓存文件的 URI(Uniform Resource Identifier),可用于标识媒体文件。

表格内容超出当前宽度,可横向滚动查看更多列。

返回值

所属接口类

RemoveOldCache

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

C#
public abstract int RemoveOldCache();

详情

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

注:

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

返回值

所属接口类

SetCacheDir

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

C#
public abstract int SetCacheDir(string path) ;

详情

注:

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

参数

参数名描述
path

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

表格内容超出当前宽度,可横向滚动查看更多列。

返回值

所属接口类

SetMaxCacheFileCount

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

C#
public abstract int SetMaxCacheFileCount(int count);

参数

参数名描述
count

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

表格内容超出当前宽度,可横向滚动查看更多列。

返回值

所属接口类

SetMaxCacheFileSize

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

C#
public abstract int SetMaxCacheFileSize(Int64 cacheSize);

参数

参数名描述
cacheSize

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

表格内容超出当前宽度,可横向滚动查看更多列。

返回值

所属接口类