# 媒体播放器缓存 (/zh-CN/api-reference/rtc/android/4.6.0/playback/media-player/mediaplayer-cache) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## enableAutoRemoveCache [#enableautoremovecache] 设置是否自动删除缓存的媒体文件。 ```java int enableAutoRemoveCache(boolean enable); ``` 当缓存的媒体文件数量或大小超过设置的限制时,启用该功能后,SDK 会自动删除最近最少使用的缓存文件。 ### 参数 [#参数] #### `enable` [#enable] 是否启用 SDK 自动删除缓存的媒体文件: - true:自动删除缓存的媒体文件。 - false:(默认)不自动删除缓存的媒体文件。 ### 返回值 [#返回值] - 0:方法调用成功。 - < 0:方法调用失败,详见 MediaPlayerReason。 ### 所属接口类 [#所属接口类] - [IMediaPlayerCacheManager](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayercachemanager) ## getCacheDir [#getcachedir] 获取缓存媒体文件的存储路径。 ```java String getCacheDir(); ``` 如果在调用该方法之前未调用 [setCacheDir](/zh-CN/api-reference/rtc/android/playback/media-player/mediaplayer-cache#api_imediaplayercachemanager_setcachedir) 设置缓存媒体文件的存储路径,则该方法返回 SDK 默认使用的存储路径。 ### 返回值 [#返回值-1] 方法调用成功时,返回缓存媒体文件的存储路径。 方法调用失败,返回空字符串。 ### 所属接口类 [#所属接口类-1] - [IMediaPlayerCacheManager](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayercachemanager) ## getCacheFileCount [#getcachefilecount] 获取已缓存的媒体文件数量。 ```java int getCacheFileCount(); ``` ### 返回值 [#返回值-2] - 0:方法调用成功,返回已缓存的媒体文件数量。 - < 0:方法调用失败,详见 MediaPlayerReason。 ### 所属接口类 [#所属接口类-2] - [IMediaPlayerCacheManager](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayercachemanager) ## getMaxCacheFileCount [#getmaxcachefilecount] 获取可缓存的媒体文件的最大数量。 ```java int getMaxCacheFileCount(); ``` 默认情况下,可缓存的媒体文件最大数量为 1000。 ### 返回值 [#返回值-3] - 0:方法调用成功,返回获取可缓存的媒体文件的最大数量。 - < 0:方法调用失败,详见 MediaPlayerReason。 ### 所属接口类 [#所属接口类-3] - [IMediaPlayerCacheManager](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayercachemanager) ## getMaxCacheFileSize [#getmaxcachefilesize] 获取缓存媒体文件聚合存储空间的最大大小。 ```java long getMaxCacheFileSize(); ``` 你可以调用 [setMaxCacheFileSize](/zh-CN/api-reference/rtc/android/playback/media-player/mediaplayer-cache#api_imediaplayercachemanager_setmaxcachefilesize) 方法根据实际场景设置缓存媒体文件聚合存储空间的最大大小。 ### 返回值 [#返回值-4] - > 0:方法调用成功,返回缓存媒体文件聚合存储空间的最大大小(单位为字节)。 - < 0:方法调用失败,详见 MediaPlayerReason。 ### 所属接口类 [#所属接口类-4] - [IMediaPlayerCacheManager](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayercachemanager) ## removeAllCaches [#removeallcaches] 删除媒体播放器中所有缓存的媒体文件。 ```java int removeAllCaches(); ``` :::info[注] 当前正在播放的缓存媒体文件不会被删除。 ::: ### 返回值 [#返回值-5] - 0:方法调用成功。 - < 0:方法调用失败,详见 MediaPlayerReason。 ### 所属接口类 [#所属接口类-5] - [IMediaPlayerCacheManager](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayercachemanager) ## removeCacheByUri [#removecachebyuri] 删除缓存的媒体文件。 ```java int removeCacheByUri(String uri); ``` :::info[注] 当前正在播放的缓存媒体文件不会被删除。 ::: ### 参数 [#参数-1] #### `uri` [#uri] 要删除的媒体文件的 URI(统一资源标识符)。 ### 返回值 [#返回值-6] - 0:方法调用成功。 - < 0:方法调用失败,详见 MediaPlayerReason。 ### 所属接口类 [#所属接口类-6] - [IMediaPlayerCacheManager](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayercachemanager) ## removeOldCache [#removeoldcache] 删除最少使用的缓存媒体文件。 ```java int removeOldCache(); ``` 你可以在缓存文件的存储空间即将达到上限时调用该方法。调用该方法后,SDK 会删除最少使用的缓存媒体文件。 :::info[注] [removeOldCache](/zh-CN/api-reference/rtc/android/playback/media-player/mediaplayer-cache#api_imediaplayercachemanager_removeoldcache) 不会删除当前正在播放的缓存媒体文件。 ::: ### 返回值 [#返回值-7] - 0:方法调用成功。 - < 0:方法调用失败,详见 MediaPlayerReason。 ### 所属接口类 [#所属接口类-7] - [IMediaPlayerCacheManager](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayercachemanager) ## setCacheDir [#setcachedir] 设置要缓存的媒体文件的存储路径。 ```java int setCacheDir(String path); ``` :::info[注] 请确保在调用该方法前已初始化 [RtcEngine](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_irtcengine)。 ::: ### 参数 [#参数-2] #### `path` [#path] 要缓存的媒体文件的绝对路径。确保该目录已存在且可写。 ### 返回值 [#返回值-8] - 0:方法调用成功。 - < 0:方法调用失败,详见 MediaPlayerReason。 ### 所属接口类 [#所属接口类-8] - [IMediaPlayerCacheManager](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayercachemanager) ## setMaxCacheFileCount [#setmaxcachefilecount] 设置可缓存的媒体文件数量上限。 ```java int setMaxCacheFileCount(int count); ``` ### 参数 [#参数-3] #### `count` [#count] 可缓存的媒体文件数量上限(默认值为 1000)。 ### 返回值 [#返回值-9] - 0:方法调用成功。 - < 0:方法调用失败,详见 MediaPlayerReason。 ### 所属接口类 [#所属接口类-9] - [IMediaPlayerCacheManager](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayercachemanager) ## setMaxCacheFileSize [#setmaxcachefilesize] 设置缓存媒体文件的聚合存储空间的最大大小。 ```java int setMaxCacheFileSize(long cacheSize); ``` ### 参数 [#参数-4] #### `cacheSize` [#cachesize] 缓存媒体文件的聚合存储空间的最大大小,单位为字节。(默认值为 1 GB。) ### 返回值 [#返回值-10] - 0:方法调用成功。 - < 0:方法调用失败,详见 MediaPlayerReason。 ### 所属接口类 [#所属接口类-10] - [IMediaPlayerCacheManager](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayercachemanager) ## onPlayerCacheStats [#onplayercachestats] 报告正在缓存的媒体文件的统计信息回调。 ```java void onPlayerCacheStats(CacheStatistics stats) ``` 调用 [openWithMediaSource](/zh-CN/api-reference/rtc/android/playback/media-player/mediaplayer-open#api_imediaplayer_openwithmediasource) 方法并将 `enableCache` 设置为 true 后,SDK 每秒触发一次该回调。 ### 触发时机 [#触发时机] 该回调在调用 [openWithMediaSource](/zh-CN/api-reference/rtc/android/playback/media-player/mediaplayer-open#api_imediaplayer_openwithmediasource) 方法并将 `enableCache` 设置为 true 后,每秒触发一次。 ### 参数 [#参数-5] #### `stats` [#stats] 正在缓存的媒体文件的统计信息。详见 [CacheStatistics](/zh-CN/api-reference/rtc/android/class-and-enum/classes/class-cachestatistics)。 ### 所属接口类 [#所属接口类-11] - [IMediaPlayerObserver](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayersourceobserver)