このページは Cloud Translation API によって翻訳されました。

リッチコンテンツを受信する

**図 1.** Unified API では特定の UI メカニズムに関係なく、受信コンテンツをタッチ決済とメニューを長押しするか、ドラッグ&ドロップします。

ユーザーは画像や動画などの表現力豊かなコンテンツを好みますが、アプリ内のコンテンツの移行は必ずしも簡単ではありません。アプリが機能に加え、Android 12（API レベル 31）では、を使用すると、クリップボード、キーボード、ドラッグなど、あらゆるソースからのコンテンツを受け付けます。

OnReceiveContentListener などのインターフェースを UI コンポーネントに接続すると、任意のメカニズムを通じてコンテンツが挿入されたときにコールバックを取得できます。コードでは、このコールバック 1 か所で、プレーンテキストや書式付きテキストからマークアップ、画像、動画、音声ファイルまで、あらゆるコンテンツの受信を処理できるようになります。

以前の Android バージョンとの下位互換性を維持するため、この API は AndroidX で利用できますが、 Core 1.7 と Appcompat 1.4、実装することをおすすめします

概要

その他の既存の API では、各 UI メカニズム（タップやメニューを長押ししますそれぞれ独自の API が用意されています。これは、コンテンツを挿入するメカニズムごとに類似のコードを追加して、各 API を個別に統合する必要があることを意味します。

さまざまなアクションと実装する相対 API を示す画像 — **図 2.** 以前は UI ごとに異なる API がアプリで実装されていたメカニズムがあります。

OnReceiveContentListener API は実装する API を 1 つにし、このさまざまなコードパスを統合します。これにより、デベロッパーはアプリ固有のロジックに集中し、それ以外の処理はプラットフォームに委ねることができます。

簡素化された統合 API を示す画像 — **図 3.** Unified API を使用すると、単一のすべての UI メカニズムをサポートする API。

このアプローチでは、コンテンツを挿入する新しい方法が機能するため、サポートを有効にするために追加のコード変更を行う必要はありません。説明しますまた、アプリ用に完全なカスタマイズを実装する必要がある場合は、引き続き使用できる既存の API は引き続き使用できます。できます。

実装

この API は、単一メソッド OnReceiveContentListener とのリスナーインターフェースです。古いバージョンの Android プラットフォームをサポートするには、それに対応する AndroidX Core ライブラリの OnReceiveContentListener インターフェースの使用をおすすめします。

API を使用するには、アプリが処理できるコンテンツのタイプを指定して、リスナーを実装します。

KotlinJava

object MyReceiver : OnReceiveContentListener {
    val MIME_TYPES = arrayOf("image/*", "video/*")
    
    // ...
    
    override fun onReceiveContent(view: View, payload: ContentInfoCompat): ContentInfoCompat? {
        TODO("Not yet implemented")
    }
}

public class MyReceiver implements OnReceiveContentListener {
     public static final String[] MIME_TYPES = new String[] {"image/*", "video/*"};
     // ...
}

アプリがサポートするすべてのコンテンツ MIME タイプを指定した後、リスナーの残りの部分を実装します。

KotlinJava

class MyReceiver : OnReceiveContentListener {
    override fun onReceiveContent(view: View, contentInfo: ContentInfoCompat): ContentInfoCompat {
        val split = contentInfo.partition { item: ClipData.Item -> item.uri != null }
        val uriContent = split.first
        val remaining = split.second
        if (uriContent != null) {
            // App-specific logic to handle the URI(s) in uriContent.
        }
        // Return anything that your app didn't handle. This preserves the
        // default platform behavior for text and anything else that you aren't
        // implementing custom handling for.
        return remaining
    }

    companion object {
        val MIME_TYPES = arrayOf("image/*", "video/*")
    }
}

 public class MyReceiver implements OnReceiveContentListener {
     public static final String[] MIME_TYPES = new String[] {"image/*", "video/*"};

     @Override
     public ContentInfoCompat onReceiveContent(View view, ContentInfoCompat contentInfo) {
         Pair<ContentInfoCompat, ContentInfoCompat> split = contentInfo.partition(
                 item -> item.getUri() != null);
         ContentInfo uriContent = split.first;
         ContentInfo remaining = split.second;
         if (uriContent != null) {
             // App-specific logic to handle the URI(s) in uriContent.
         }
         // Return anything that your app didn't handle. This preserves the
         // default platform behavior for text and anything else that you aren't
         // implementing custom handling for.
         return remaining;
     }
 }

アプリですでにインテントを使用した共有をサポートしている場合は、コンテンツ URI を処理するためのアプリ固有のロジック。残りすべてのデータを結果から取得し、そのデータの処理をプラットフォームに委ねます。

リスナーを実装したら、アプリの適切な UI 要素でリスナーを設定します。

KotlinJava

class MyActivity : Activity() {
    public override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // ...
        val myInput = findViewById(R.id.my_input)
        ViewCompat.setOnReceiveContentListener(myInput, MyReceiver.MIME_TYPES, MyReceiver())
    }
}

public class MyActivity extends Activity {
     @Override
     public void onCreate(Bundle savedInstanceState) {
         // ...

         AppCompatEditText myInput = findViewById(R.id.my_input);
         ViewCompat.setOnReceiveContentListener(myInput, MyReceiver.MIME_TYPES, new MyReceiver());
     }
}

URI 権限

読み取り権限は、OnReceiveContentListener に渡されたペイロード内のコンテンツ URI に対して、プラットフォームにより自動的に付与、解放されます。

通常、アプリはサービスまたはアクティビティでコンテンツ URI を処理します。対象長時間実行処理、 WorkManager。これを実装する場合は、Intent.setClipData を使用してコンテンツを渡し、FLAG_GRANT_READ_URI_PERMISSION のフラグを設定することで、ターゲットサービスまたはアクティビティに権限を拡張する必要があります。

また、現在のコンテキスト内でバックグラウンドスレッドを使用してコンテンツを処理することもできます。この場合、リスナーが受け取った payload オブジェクトへの参照を維持して、プラットフォームにより権限が早期に取り消されないようにします。

カスタムビュー

アプリでカスタムの View サブクラスを使用する場合は、OnReceiveContentListener がバイパスされないように注意してください。

View クラスで onCreateInputConnection メソッドをオーバーライドする場合は、Jetpack API の InputConnectionCompat.createWrapper を使用して InputConnection を構成してください。

View クラスが onTextContextMenuItem メソッドで、メニュー項目が移動したときに super にデリゲート R.id.paste または R.id.pasteAsPlainText。

Keyboard Image API との比較

OnReceiveContentListener API は、既存の Keyboard Image API の次期バージョンと考えることができます。この Unified API は、Keyboard Image API の機能に加えて、いくつかの追加機能をサポートします。デバイスと機能の互換性は、Jetpack ライブラリを使用するか、Android SDK のネイティブ API を使用するかによって異なります。

**表 1.** Jetpack でサポートされている機能と API レベル。
アクションまたは機能	Keyboard Image API によるサポート	Unified API によるサポート
キーボードからの挿入	あり（API レベル 13 以上）	あり（API レベル 13 以上）
タッチ操作で貼り付けを使用して挿入メニューを長押しします	なし	あり
ドラッグ&ドロップで挿入する	なし	あり（API レベル 24 以上）

**表 2.** ネイティブでサポートされている機能と API レベル API。
アクションまたは機能	Keyboard Image API によるサポート	Unified API によるサポート
キーボードからの挿入	あり（API レベル 25 以上）	あり（Android 12 以降）
長押しメニューからの貼り付けによる挿入	なし
ドラッグ＆ドロップによる挿入	なし

リッチ コンテンツを受信する

概要

実装

URI 権限

カスタムビュー

Keyboard Image API との比較

リッチコンテンツを受信する