java.lang.Object | |
↳ | com.facebook.imagepipeline.request.MediaVariations |
An optional part of image requests which describes the piece of media being requested.
This allows for the provision of a number of image variants which are identical in content but at different resolutions. This way if the image at the source URI isn't already cached an appropriate fallback may be used instead.
Even without explicitly including the variants, by using the same media ID across multiple image requests, the pipeline may build up a knowledge of these and fulfil requests accordingly.
This extra functionality is currently only enabled if
getMediaVariationsIndexEnabled()
is true in the image pipeline config.
Nested Classes | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
class | MediaVariations.Builder | ||||||||||
class | MediaVariations.Variant |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
boolean | equals(Object o) | ||||||||||
static MediaVariations |
forMediaId(String mediaId)
Creates an instance with a media ID and without specific variants.
| ||||||||||
String |
getMediaId()
Get the unique ID for this piece of media.
| ||||||||||
List<MediaVariations.Variant> |
getVariants()
Get all known variants of this media.
| ||||||||||
int | hashCode() | ||||||||||
static MediaVariations.Builder |
newBuilderForMediaId(String mediaId)
Creates a builder for a new MediaVariations to which you can add specific variants.
| ||||||||||
boolean |
shouldForceRequestForSpecifiedUri()
Gets whether the URI in the original request should be downloaded even if another cached image
appears to be big enough for the request.
| ||||||||||
String | toString() |
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
![]() |
Creates an instance with a media ID and without specific variants. If a null or empty ID is given, null is returned.
mediaId | the unique ID for this piece of media. If this is neither null or empty, it must be unique for this piece of media (i.e. another request for the same picture at a different size should share the ID but not an unrelated image and not the same media at a different orientation). |
---|
Get the unique ID for this piece of media. This must be non-null, not empty and unique for this piece of media (i.e. another request for the same picture at a different size should share the ID but not an unrelated image and not the same media at a different orientation).
Get all known variants of this media. This may not be exhaustive and these sets may be combined over time to allow the possibilities of fallbacks being offered even when not specified in a later request.
Creates a builder for a new MediaVariations to which you can add specific variants.
mediaId | the unique ID for this piece of media. This must be non-null and unique for this piece of media (i.e. another request for the same picture at a different size should share the ID but not an unrelated image and not the same media at a different orientation). |
---|
Gets whether the URI in the original request should be downloaded even if another cached image appears to be big enough for the request.