86 lines
3.4 KiB
XML
86 lines
3.4 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!--
|
|
Copyright 2014 The Android Open Source Project
|
|
|
|
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.
|
|
-->
|
|
<sample>
|
|
<name>CommitContentSampleIME</name>
|
|
<group>Input</group>
|
|
<package>com.example.android.commitcontent.ime</package>
|
|
|
|
<minSdk>25</minSdk>
|
|
|
|
<strings>
|
|
<intro>
|
|
<![CDATA[
|
|
This sample demonstrates how to write an keyboard which sends rich content
|
|
(such as images) to text fields using the Commit Content API.
|
|
]]>
|
|
</intro>
|
|
</strings>
|
|
|
|
<template src="base-build" />
|
|
|
|
<metadata>
|
|
<status>PUBLISHED</status>
|
|
<categories>System</categories>
|
|
<technologies>Android</technologies>
|
|
<languages>Java</languages>
|
|
<solutions>Mobile</solutions>
|
|
<level>INTERMEDIATE</level>
|
|
<icon>screenshots/icon-web.png</icon>
|
|
<screenshots>
|
|
<img>screenshots/screenshot-1.png</img>
|
|
</screenshots>
|
|
<api_refs>
|
|
<android>android.widget.EditText</android>
|
|
<android>import android.support.v13.view.inputmethod.EditorInfoCompat</android>
|
|
<android>import android.support.v13.view.inputmethod.InputConnectionCompat</android>
|
|
<android>import android.support.v13.view.inputmethod.InputContentInfoCompat</android>
|
|
</api_refs>
|
|
|
|
<description>
|
|
<![CDATA[
|
|
This sample demonstrates how to write an keyboard which sends rich content (such as images) to text
|
|
fields using the Commit Content API.
|
|
]]>
|
|
</description>
|
|
|
|
<intro>
|
|
<![CDATA[
|
|
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][1], 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.
|
|
|
|
[1]: https://android-dot-devsite.googleplex.com/preview/image-keyboard.html
|
|
]]>
|
|
</intro>
|
|
</metadata>
|
|
</sample>
|