preload Clips
Preloads a Clips collection and optional single Clip IDs into the in-memory cache.
This fetches the first page of the collection and stores it in the Clips cache, then fetches each requested clip by ID so single-clip requests can read from cache. The loaded clips are also used to warm the playcard image cache to avoid a blank flash on first open.
Important: You must retain a strong reference to the returned StorytellerClipPreloadHandle while preloading is in progress. If the handle is garbage collected, preloading will stop.
Return
A StorytellerClipPreloadHandle to cancel preloading, or null if the input is invalid or the SDK is not initialized.
Parameters
The Clips collection ID to preload.
Optional list of Clip IDs to preload (useful for clips beyond page 0).
Whether to preload clip video content in addition to playcards.