EmbeddedPhotoPickerProvider

public interface EmbeddedPhotoPickerProvider

This interface provides an api that callers can use to get a session of embedded PhotoPicker (EmbeddedPhotoPickerSession).

Callers can get instance of this class using EmbeddedPhotoPickerProviderFactory.create(Context).

Under the hood, a service connection with photopicker is established by the implementation of this api. To help establish this connection, a caller must include in their Manifest:

<queries>
   <intent>
       <action android:name="com.android.photopicker.core.embedded.EmbeddedService.BIND"/>
   </intent>
 </queries>
 

When a session opens successfully, they would receive an instance of EmbeddedPhotoPickerSession and SurfaceControlViewHost.SurfacePackage via the api

Callers pass an instance of EmbeddedPhotoPickerClient which is used by service to notify about different events (like sessionError, uri granted/revoked etc) to them. One-to-one relationship of client to session must be maintained by a caller i.e. they shouldn't reuse same callback for more than one openSession requests.

The EmbeddedPhotoPickerSession instance can be used to notify photopicker about different events (like resize, configChange etc).

This api is supported on api versions Android U+.

Summary

Public methods

public abstract void openSession (IBinder hostToken, 
                int displayId, 
                int width, 
                int height, 
                EmbeddedPhotoPickerFeatureInfo featureInfo, 
                Executor clientExecutor, 
                EmbeddedPhotoPickerClient callback)