OnReceiveContentListener

public interface OnReceiveContentListener

Listener for apps to implement handling for insertion of content. Content may be both text and non-text (plain/styled text, HTML, images, videos, audio files, etc).

This listener can be attached to different types of UI components using View#setOnReceiveContentListener.

Here is a sample implementation that handles content URIs and delegates the processing for text and everything else to the platform:

 // (1) Define the listener
 public class MyReceiver implements OnReceiveContentListener {
     public static final String[] MIME_TYPES = new String[] {"image/*", "video/*"};

     @Override
     public ContentInfo onReceiveContent(View view, ContentInfo payload) {
         Pair<ContentInfo, ContentInfo> split =
                 ContentInfoCompat.partition(payload, item -> item.getUri() != null);
         ContentInfo uriContent = split.first;
         ContentInfo remaining = split.second;
         if (uriContent != null) {
             ClipData clip = uriContent.getClip();
             for (int i = 0; i < clip.getItemCount(); i++) {
                 Uri uri = clip.getItemAt(i).getUri();
                 // ... app-specific logic to handle the URI ...
             }
         }
         // Return anything that we didn't handle ourselves. This preserves the default platform
         // behavior for text and anything else for which we are not implementing custom handling.
         return remaining;
     }
 }

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

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

Summary

Public methods

public abstract ContentInfo onReceiveContent (View view, 
                ContentInfo payload)