This library is a wrapper Giphy's wonderful API and allows you to easily include animated GIFs in your projects.
The library will start by showing the trending GIFs then allow the user to search through Giphy's vast amount of animations.
GIFs are automatically played when the user scrolls through them, then, when the user clicks a GIF, it will be downloaded and the resulting file://
URI will be returned to your Activity
.
The library is extremely easy to implement, as shown below. Enjoy all the GIFs!
In your project's root build.gradle
(not your module's build.gradle
):
allprojects {
repositories {
...
jcenter()
}
}
To include it in your project, add this to your module's build.gradle
file:
dependencies {
...
compile 'com.klinkerapps:giphy:2.1.2'
}
and resync the project.
To create a giphy search activity, you can use Giphy.Builder
:
new Giphy.Builder(activity, "dc6zaTOxFJmzC") // Giphy's BETA key
.maxFileSize(5 * 1024 * 1024) // 5 mb
.start();
Max file size is optional. In your activity, listen for the results:
@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
if (requestCode == Giphy.REQUEST_GIPHY) {
if (resultCode == Activity.RESULT_OK) {
Uri gif = data.getData();
// do something with the uri.
}
} else {
super.onActivityResult(requestCode, resultCode, data);
}
}
Giphy makes a public BETA API key available for any one to use during testing: dc6zaTOxFJmzC
.
They say that this BETA key is rate limited, so I recommend applying for a production key.
Copyright (C) 2016 Jake Klinker, Luke Klinker
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.