# 媒体播放器缓存 (/zh-CN/api-reference/rtc/csharp-windows/play/mediaplayer-cache) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## EnableAutoRemoveCache [#enableautoremovecache] 设置是否开启自动清除缓存文件功能。 ```csharp public abstract int EnableAutoRemoveCache(bool enable); ``` ### 详情 [#详情] 开启自动清除缓存文件后,当播放器中缓存的媒体文件超过你设置的文件数量或总缓存大小的上限时,SDK 会自动清除近期最少使用的一个缓存文件。 ### 参数 [#参数] 是否自动清除缓存文件: - `true`:开启自动清除缓存文件功能。 - `false`:(默认)关闭自动清除缓存文件功能。 ### 返回值 [#返回值] - 0:方法调用成功。 - < 0:方法调用失败,详见 [MEDIA_PLAYER_REASON](/zh-CN/api-reference/rtc/csharp-windows/enum-mediaplayerreason)。 ### 所属接口类 [#所属接口类] - [IMediaPlayerCacheManager](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_imediaplayercachemanager) ## GetCacheDir [#getcachedir] 获取缓存文件的储存路径。 ```csharp public abstract int GetCacheDir(out string path, int length); ``` ### 详情 [#详情-1] 如果你在调用该方法前未曾调用 [SetCacheDir](/zh-CN/api-reference/rtc/csharp-windows/play/mediaplayer-cache#api_imediaplayercachemanager_setcachedir) 方法自定义缓存文件的储存路径,该方法返回的为 SDK 默认的缓存文件储存路径。 ### 参数 [#参数-1] 输出参数,缓存文件的储存路径。 输入参数,缓存文件储存路径字符串的最大长度。根据你在 path 中获得的缓存文件储存路径字符串来填写。 ### 返回值 [#返回值-1] - 0:方法调用成功。 - < 0:方法调用失败,详见 [MEDIA_PLAYER_REASON](/zh-CN/api-reference/rtc/csharp-windows/enum-mediaplayerreason)。 ### 所属接口类 [#所属接口类-1] - [IMediaPlayerCacheManager](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_imediaplayercachemanager) ## GetCacheFileCount [#getcachefilecount] 获取当前已缓存的媒体文件的总数量。 ```csharp public abstract int GetCacheFileCount(); ``` ### 返回值 [#返回值-2] - ≥ 0:方法调用成功,返回当前已缓存的媒体文件的总数量。 - < 0:方法调用失败,详见 [MEDIA_PLAYER_REASON](/zh-CN/api-reference/rtc/csharp-windows/enum-mediaplayerreason)。 ### 所属接口类 [#所属接口类-2] - [IMediaPlayerCacheManager](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_imediaplayercachemanager) ## GetMaxCacheFileCount [#getmaxcachefilecount] 获取所设置的缓存文件数量上限。 ```csharp public abstract int GetMaxCacheFileCount(); ``` ### 详情 [#详情-2] SDK 默认的缓存文件数量上限为 1000。 ### 返回值 [#返回值-3] - > 0:方法调用成功,返回缓存文件数量的上限。 - < 0:方法调用失败,详见 [MEDIA_PLAYER_REASON](/zh-CN/api-reference/rtc/csharp-windows/enum-mediaplayerreason)。 ### 所属接口类 [#所属接口类-3] - [IMediaPlayerCacheManager](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_imediaplayercachemanager) ## GetMaxCacheFileSize [#getmaxcachefilesize] 获取所设置的缓存文件总缓存的上限。 ```csharp public abstract Int64 GetMaxCacheFileSize(); ``` ### 详情 [#详情-3] SDK 默认的缓存文件总缓存上限为 1GB。你可以调用 [SetMaxCacheFileSize](/zh-CN/api-reference/rtc/csharp-windows/play/mediaplayer-cache#api_imediaplayercachemanager_setmaxcachefilesize) 方法自定义总缓存大小的上限。 ### 返回值 [#返回值-4] - > 0:方法调用成功,返回缓存文件的总缓存上限,单位为字节。 - < 0:方法调用失败,详见 [MEDIA_PLAYER_REASON](/zh-CN/api-reference/rtc/csharp-windows/enum-mediaplayerreason)。 ### 所属接口类 [#所属接口类-4] - [IMediaPlayerCacheManager](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_imediaplayercachemanager) ## RemoveAllCaches [#removeallcaches] 删除媒体播放器中所有已缓存的媒体文件。 ```csharp public abstract int RemoveAllCaches(); ``` ### 详情 [#详情-4] :::note 注: 该方法不会删除正在播放中的已缓存媒体文件。 ::: ### 返回值 [#返回值-5] - 0:方法调用成功。 - < 0:方法调用失败,详见 [MEDIA_PLAYER_REASON](/zh-CN/api-reference/rtc/csharp-windows/enum-mediaplayerreason)。 ### 所属接口类 [#所属接口类-5] - [IMediaPlayerCacheManager](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_imediaplayercachemanager) ## RemoveCacheByUri [#removecachebyuri] 删除指定的已缓存媒体文件。 ```csharp public abstract int RemoveCacheByUri(string uri) ; ``` ### 详情 [#详情-5] :::note 注: 该方法不会删除正在播放中的已缓存媒体文件。 ::: ### 参数 [#参数-2] 待删除的缓存文件的 URI(Uniform Resource Identifier),可用于标识媒体文件。 ### 返回值 [#返回值-6] - 0:方法调用成功。 - < 0:方法调用失败,详见 [MEDIA_PLAYER_REASON](/zh-CN/api-reference/rtc/csharp-windows/enum-mediaplayerreason)。 ### 所属接口类 [#所属接口类-6] - [IMediaPlayerCacheManager](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_imediaplayercachemanager) ## RemoveOldCache [#removeoldcache] 删除媒体播放器中近期最少使用的一个缓存媒体文件。 ```csharp public abstract int RemoveOldCache(); ``` ### 详情 [#详情-6] 缓存媒体文件占用过多空间时,你可以调用该方法清理缓存文件。调用该方法后,SDK 会删除最少使用的一个缓存媒体文件。 :::note 注: 当你调用此方法删除缓存媒体文件时,当前正在播放的已缓存媒体文件不会被删除。 ::: ### 返回值 [#返回值-7] - 0:方法调用成功。 - < 0:方法调用失败,详见 [MEDIA_PLAYER_REASON](/zh-CN/api-reference/rtc/csharp-windows/enum-mediaplayerreason)。 ### 所属接口类 [#所属接口类-7] - [IMediaPlayerCacheManager](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_imediaplayercachemanager) ## SetCacheDir [#setcachedir] 设置待缓存的媒体文件的储存路径。 ```csharp public abstract int SetCacheDir(string path) ; ``` ### 详情 [#详情-7] :::note 注: 该方法需在初始化 [IRtcEngine](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengine) 之后调用。 ::: ### 参数 [#参数-3] 缓存文件储存的绝对路径。请确保指定的目录存在且可写。 ### 返回值 [#返回值-8] - 0:方法调用成功。 - < 0:方法调用失败,详见 [MEDIA_PLAYER_REASON](/zh-CN/api-reference/rtc/csharp-windows/enum-mediaplayerreason)。 ### 所属接口类 [#所属接口类-8] - [IMediaPlayerCacheManager](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_imediaplayercachemanager) ## SetMaxCacheFileCount [#setmaxcachefilecount] 设置缓存媒体文件数量的上限。 ```csharp public abstract int SetMaxCacheFileCount(int count); ``` ### 参数 [#参数-4] 可缓存的媒体文件数量的上限,默认值为 1000。 ### 返回值 [#返回值-9] - 0:方法调用成功。 - < 0:方法调用失败,详见 [MEDIA_PLAYER_REASON](/zh-CN/api-reference/rtc/csharp-windows/enum-mediaplayerreason)。 ### 所属接口类 [#所属接口类-9] - [IMediaPlayerCacheManager](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_imediaplayercachemanager) ## SetMaxCacheFileSize [#setmaxcachefilesize] 设置缓存媒体文件的总缓存大小的上限。 ```csharp public abstract int SetMaxCacheFileSize(Int64 cacheSize); ``` ### 参数 [#参数-5] 缓存媒体文件的总缓存上限,单位为字节。默认为 1 GB。 ### 返回值 [#返回值-10] - 0:方法调用成功。 - < 0:方法调用失败,详见 [MEDIA_PLAYER_REASON](/zh-CN/api-reference/rtc/csharp-windows/enum-mediaplayerreason)。 ### 所属接口类 [#所属接口类-10] - [IMediaPlayerCacheManager](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_imediaplayercachemanager)