Media URLs & Cache

File caching is application-level functionality and is not included in the stable SPLive 2.0.0 public SDK.

Recommended Flutter tools

• cached_network_image for room covers and avatars.
• flutter_cache_manager for general downloaded files.
• just_audio caching or preload strategies for room music.
• Local temporary storage for gift-animation assets.

Use absolute URLs

Laravel should return complete HTTPS URLs. A path such as /storage/rooms/27/music/file.mp3 may be interpreted as a local Android file path.

{
  "audio_url": "https://api.example.com/storage/rooms/27/music/file.mp3"
}

Cache invalidation

Use versioned file names, query parameters, or immutable asset paths when replacing room backgrounds, gift images, or audio tracks.