This new service creates animated text results for search queries where there are no matching results in GIPHY's library. These results are returned in a number of different animation styles giving your users a variety of options to best express themselves.
- GIPHY SDK v2.0.5 (or above)
- To access this feature, you'll need to create a new SDK Key
- This feature isn't as 'plug-and-play' as the other features of the SDK. Some additional setup and logic is required to properly offer it in your app.
Ensure that the .text
GPHContentType
is included in your mediaTypeConfig
array.
giphyViewController.mediaTypeConfig = [.gifs, .stickers, .text]
Enable the GIPHY Text creation experience in the GiphyViewController
by setting the enableDynamicText
flag to true:
giphyViewController.enableDynamicText = true
The isDynamic
property of GPHMedia
signifies animated text assets that are dynamically generated based on user input and are not indexed in the GIPHY Library.
As a result, the id
property of dynamic media does not represent a normal GIPHY id
. Properties and operations such as gifByID
will not work properly for them.
For media that isDynamic
, it is necessary to send or store the asset url, rather than just the media id
. It is not possible to fetch the image assets from the id
.
if media.isDynamic { // handle accordingly }
This feature is exposed as an additional GPHContent
(.animate
) constructor analogous to the existing .search
and .trending
constructors
let trending = GPHContent.trending(mediaType: .sticker)
let search = GPHContent.search(withQuery: "hello", mediaType: .gif, language: .english)
// new:
let animatedText = GPHContent.animate("hey what up! hope this all makes sense.")
When populating the GiphyGridController
with dynamic text, provide a visual indicator to clarify to the user that they are in a creation context as opposed to a search context.
We will only return GIF & WebP files for dynamic text. These are renditions available: original
, fixed_width
, fixed_width_downsampled
, fixed_width_small
, preview_gif
, preview_webp
.