Skip to content
Branch: master
Find file History
Permalink
Type Name Latest commit message Commit time
..
Failed to load latest commit information.
.google
app
gradle/wrapper
screenshots
README.md
build.gradle
gradle.properties Adds CommitContentSampleIME sample to repo. Jul 30, 2019
gradlew
gradlew.bat
settings.gradle

README.md

Android CommitContentSampleIME Sample

This sample demonstrates how to write an keyboard which sends rich content (such as images) to text fields using the Commit Content API.

Introduction

Users often want to communicate with emojis, stickers, and other kinds of rich content. In previous versions of Android, soft keyboards (input method editors or IMEs) could send only unicode emoji to apps. For rich content (such as images), apps had to either build app-specific APIs that couldn't be used in other apps or use workarounds like sending images through the Easy Share Action or the clipboard.

Now in Android 7.1 (API 25), the Android SDK includes the Commit Content API, which provides a universal way for IMEs to send images and other rich content directly to a text editor in an app. The API is also available in the v13 Support Library (ver. 25.0), supporting devices as early as Android 3.2 (API 13).

With this API, you can build messaging apps that accept rich content from any keyboard, as well as keyboards that can send rich content to any app.

Note: This sample does not have a default Activity. After installing it, you will need to enable this app as a keyboard by navigating to Settings > Languages & Input > Virtual Keyboard > Manage Keyboards. This keyboard can then be accessed by pressing the virtual keyboard icon in the lower-right hand corner of the display while in a text field.

Pre-requisites

  • Android SDK 28
  • Android Build Tools v28.0.3
  • Android Support Repository

Screenshots

Screenshot

Getting Started

This sample uses the Gradle build system. To build this project, use the "gradlew build" command or use "Import Project" in Android Studio.

Support

If you've found an error in this sample, please file an issue: https://github.com/android/input

Patches are encouraged, and may be submitted by forking this project and submitting a pull request through GitHub. Please see CONTRIBUTING.md for more details.

You can’t perform that action at this time.