A helper library to deep link into the official Vimeo Android Mobile App.
Note - the Vimeo Android TV application does not have support for deep linking. This library is intended to aid in deep linking to the mobile phone and tablet application only.
- Getting Started
- Gradle
- Submodule
- Reference
- View app in the Google Play store
- Check if the Vimeo app is installed
- Open the Vimeo app
- View a video in the Vimeo app
- View a user profile in the Vimeo app
- View a category in the Vimeo app
- View a channel in the Vimeo app
- View an On Demand film or series in the Vimeo app
- Open the All Categories page
- Open the Explore page
- Open the Feed
- Open the current user's profile
- Open the Playlists page
- Open the Offline playlist page
- Open the Notifications page
- Open the Watch Later page
- Open the Purchases page
- Open the Camera roll to start the upload flow
For a more in depth look at the usage, refer to the example Android app. The example project includes implementation of all of the below features.
Specify the dependency in your build.gradle
file (make sure jcenter()
is included as a repository)
compile 'com.vimeo.android.deeplink:vimeo-deeplink:1.2.0'
We recommend using JCenter, but if you'd like to use the library as a submodule:
git submodule add [email protected]:vimeo/vimeo-deeplink-android.git
Then in your build.gradle
use:
compile project(':vimeo-deeplink-android:vimeo-deeplink')
The Vimeo deeplink base URL is: vimeo://app.vimeo.com
Currently supported paths are:
vimeo://app.vimeo.com/videos/12345
where/videos/12345
is a video URIvimeo://app.vimeo.com/users/12345
where/users/12345
is a user URI.vimeo://app.vimeo.com/categories/12345
where/categories/12345
is a category URI.vimeo://app.vimeo.com/channels/12345
where/channels/12345
is a channel URI.vimeo://app.vimeo.com/categories
vimeo://app.vimeo.com/explore
vimeo://app.vimeo.com/feed
vimeo://app.vimeo.com/me
vimeo://app.vimeo.com/notifications
vimeo://app.vimeo.com/settings/notifications
vimeo://app.vimeo.com/offline
vimeo://app.vimeo.com/playlists
vimeo://app.vimeo.com/purchases
vimeo://app.vimeo.com/upload
boolean playStoreOpened = VimeoDeeplink.viewVimeoAppInAppStore(Context context)
boolean isInstalled = VimeoDeeplink.isVimeoAppInstalled(Context context)
boolean opened = VimeoDeeplink.openVimeoApp(Context context)
You can check if this method is supported on the installed Vimeo version using the call:
boolean supported = VimeoDeeplink.canHandleVideoDeeplink(Context context)
You must provide a video uri to this method. You can find a video's uri by making an API call to our video endpoints.
boolean handled = VimeoDeeplink.showVideoWithUri(Context context, String videoUri)
You can check if this method is supported on the installed Vimeo version using the call:
boolean supported = VimeoDeeplink.canHandleUserDeeplink(Context context)
You must provide a user uri to this method. You can find a user's uri by making an API call to our user endpoints.
boolean handled = VimeoDeeplink.showUserWithUri(Context context, String userUri)
You can check if this method is supported on the installed Vimeo version using the call:
boolean supported = VimeoDeeplink.canHandleCategoryDeeplink(Context context)
You must provide a category uri to this method. You can find a categories uri by making an API call to our category endpoints.
boolean handled = VimeoDeeplink.showCategoryWithUri(Context context, String categoryUri)
You can check if this method is supported on the installed Vimeo version using the call:
boolean supported = VimeoDeeplink.canHandleChannelDeeplink(Context context)
You must provide a channel uri to this method. You can find a channel's uri by making an API call to our channel endpoints.
boolean handled = VimeoDeeplink.showChannelWithUri(Context context, String channelUri)
You can check if this method is supported on the installed Vimeo version using the call:
boolean supported = VimeoDeeplink.canHandleOnDemandDeeplink(Context context)
You must provide an ondemand uri to this method.
boolean handled = VimeoDeeplink.showOnDemandTitleWithUri(Context context, String ondemandUri)
boolean handled = VimeoDeeplink.showCategories(Context context)
boolean handled = VimeoDeeplink.showExplore(Context context)
boolean handled = VimeoDeeplink.showFeed(Context context)
boolean handled = VimeoDeeplink.showMyProfile(Context context)
boolean handled = VimeoDeeplink.showPlaylists(Context context)
boolean handled = VimeoDeeplink.showOffline(Context context)
boolean handled = VimeoDeeplink.showNotifications(Context context)
boolean handled = VimeoDeeplink.showWatchLater(Context context)
boolean handled = VimeoDeeplink.showPurchases(Context context)
boolean handled = VimeoDeeplink.showUpload(Context context)
Please file it in the git issue tracker.
If you'd like to contribute, please follow our guidelines found in CONTRIBUTING.md.
vimeo-deeplink-android
is available under the MIT license. See the LICENSE file for more info.
Tweet at us here: @vimeoapi.
Post on Stackoverflow with the tag vimeo-android
.
Get in touch here.
Interested in working at Vimeo? We're hiring!