From e4ff1c9a9cf8a6ebbcd0580b89b6e5bd5879c377 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Fri, 14 Aug 2026 05:51:27 -0500 Subject: [PATCH 1/2] Document embedded Photo Picker APIs Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- ...EmbeddedPhotoPickerFeatureInfo+Builder.xml | 44 ++++++++----------- .../EmbeddedPhotoPickerFeatureInfo.xml | 17 +++---- .../EmbeddedPhotoPickerProviderFactory.xml | 4 +- .../IEmbeddedPhotoPickerClient.xml | 8 ++-- .../IEmbeddedPhotoPickerSession.xml | 5 +-- 5 files changed, 34 insertions(+), 44 deletions(-) diff --git a/docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerFeatureInfo+Builder.xml b/docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerFeatureInfo+Builder.xml index cd2c31de5..37a754e89 100644 --- a/docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerFeatureInfo+Builder.xml +++ b/docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerFeatureInfo+Builder.xml @@ -81,7 +81,7 @@ Build the class for desired feature info arguments - To be added. + An EmbeddedPhotoPickerFeatureInfo with the configured feature arguments. Build the class for desired feature info arguments @@ -153,10 +153,9 @@ - To be added. - To be added. - To be added. - To be added. + The desired accent color. By default, primary element colors follow the device theme. + Sets the accent color used by primary picker elements, such as the Done button, selected media icons, and tabs. + This builder. @@ -186,10 +185,9 @@ - To be added. - To be added. - To be added. - To be added. + The maximum selection count. Pass 1 to open the picker in single-select mode. + Sets the maximum number of items the user can select. + This builder. @@ -219,10 +217,9 @@ - To be added. - To be added. - To be added. - To be added. + The MIME types to filter. Values can be concrete types, such as image/png, or partial types, such as image/*. + Sets the MIME types used to filter media items. + This builder. @@ -252,10 +249,9 @@ - To be added. - To be added. - To be added. - To be added. + true to preserve the user's selection order; the default is false. + Sets whether selected media items are presented in the order in which the user selected them. + This builder. @@ -285,10 +281,9 @@ - To be added. - To be added. - To be added. - To be added. + The URIs to preselect when the embedded picker opens. + Sets the media item URIs that are preselected when the embedded picker opens. + This builder. @@ -318,10 +313,9 @@ - To be added. - To be added. - To be added. - To be added. + A Configuration.UI_MODE_NIGHT_* value. The default, UI_MODE_NIGHT_UNDEFINED, uses the system theme. + Sets the embedded picker theme to light or dark independently of the device theme. + This builder. diff --git a/docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerFeatureInfo.xml b/docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerFeatureInfo.xml index 6e02fa602..cac5973e7 100644 --- a/docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerFeatureInfo.xml +++ b/docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerFeatureInfo.xml @@ -121,9 +121,8 @@ Android.OS.IParcelableCreator - To be added. - To be added. - To be added. + Creates EmbeddedPhotoPickerFeatureInfo instances from a Parcel. + A Parcelable.Creator for EmbeddedPhotoPickerFeatureInfo. @@ -154,9 +153,8 @@ - To be added. - To be added. - To be added. + Describes the special objects contained in this parcelable's marshaled representation. + A bitmask of the special object types in the marshaled representation, or 0. @@ -432,10 +430,9 @@ - To be added. - To be added. - To be added. - To be added. + The Parcel in which to write this object. + Additional flags controlling how to write this object. + Flattens this object into a Parcel. diff --git a/docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerProviderFactory.xml b/docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerProviderFactory.xml index bb5d781e8..009c53fa7 100644 --- a/docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerProviderFactory.xml +++ b/docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerProviderFactory.xml @@ -95,9 +95,9 @@ - To be added. + The context used to create the provider. Returns an implementation of EmbeddedPhotoPickerProvider class. - To be added. + An EmbeddedPhotoPickerProvider implementation. Returns an implementation of EmbeddedPhotoPickerProvider class. diff --git a/docs/xml/Android.Widget.PhotoPicker/IEmbeddedPhotoPickerClient.xml b/docs/xml/Android.Widget.PhotoPicker/IEmbeddedPhotoPickerClient.xml index 0019dd1b7..a958cbaf9 100644 --- a/docs/xml/Android.Widget.PhotoPicker/IEmbeddedPhotoPickerClient.xml +++ b/docs/xml/Android.Widget.PhotoPicker/IEmbeddedPhotoPickerClient.xml @@ -121,7 +121,7 @@ - To be added. + The non-null error that terminated the session. Reports that terminal error has occurred in the session. Reports that terminal error has occurred in the session. Any further events @@ -167,7 +167,7 @@ - To be added. + The non-null session established with the embedded Photo Picker. Reports that session of app with photopicker was established successfully. Reports that session of app with photopicker was established successfully. @@ -213,7 +213,7 @@ - To be added. + The non-null URI list for which permission was granted. Reports that URI permission has been granted to the item selected by the user. Reports that URI permission has been granted to the item selected by the user. @@ -261,7 +261,7 @@ - To be added. + The non-null URI list for which permission was revoked. Reports that URI permission has been revoked of the item deselected by the user. diff --git a/docs/xml/Android.Widget.PhotoPicker/IEmbeddedPhotoPickerSession.xml b/docs/xml/Android.Widget.PhotoPicker/IEmbeddedPhotoPickerSession.xml index 0d5532b8c..9b6aa6295 100644 --- a/docs/xml/Android.Widget.PhotoPicker/IEmbeddedPhotoPickerSession.xml +++ b/docs/xml/Android.Widget.PhotoPicker/IEmbeddedPhotoPickerSession.xml @@ -349,9 +349,8 @@ Android.Views.SurfaceControlViewHost+SurfacePackage - To be added. - To be added. - To be added. + Returns the SurfaceControlViewHost.SurfacePackage containing the embedded picker view. + A surface package callers can attach to their view hierarchy using SurfaceView.setChildSurfacePackage. From fc031d082bfdcd8da783be580432ab487421118b Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Fri, 14 Aug 2026 20:32:32 -0500 Subject: [PATCH 2/2] Clarify Photo Picker builder constraints Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../EmbeddedPhotoPickerFeatureInfo+Builder.xml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerFeatureInfo+Builder.xml b/docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerFeatureInfo+Builder.xml index 37a754e89..e4664ebca 100644 --- a/docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerFeatureInfo+Builder.xml +++ b/docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerFeatureInfo+Builder.xml @@ -185,7 +185,7 @@ - The maximum selection count. Pass 1 to open the picker in single-select mode. + The maximum selection count, from 1 through 100. Pass 1 to open the picker in single-select mode. Sets the maximum number of items the user can select. This builder. @@ -217,7 +217,7 @@ - The MIME types to filter. Values can be concrete types, such as image/png, or partial types, such as image/*. + The image or video MIME types to filter. Values can be concrete types, such as image/png, or partial types, such as image/* or video/*. Sets the MIME types used to filter media items. This builder. @@ -313,7 +313,7 @@ - A Configuration.UI_MODE_NIGHT_* value. The default, UI_MODE_NIGHT_UNDEFINED, uses the system theme. + One of Configuration.UiModeNightUndefined, Configuration.UiModeNightNo, or Configuration.UiModeNightYes. The default, Configuration.UiModeNightUndefined, uses the system theme. Sets the embedded picker theme to light or dark independently of the device theme. This builder.