From b9fb37e4b8bdbfe94e312b695ddf901a576ded02 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Sun, 16 Aug 2026 09:37:28 -0500 Subject: [PATCH 1/4] Document media session playback flags Refs #137 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- docs/xml/Android.Media.Session/MediaController.xml | 2 +- docs/xml/Android.Media.Session/MediaPlaybackType.xml | 4 ++-- docs/xml/Android.Media.Session/MediaSessionFlags.xml | 4 ++-- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/xml/Android.Media.Session/MediaController.xml b/docs/xml/Android.Media.Session/MediaController.xml index a7da18668..f25e54361 100644 --- a/docs/xml/Android.Media.Session/MediaController.xml +++ b/docs/xml/Android.Media.Session/MediaController.xml @@ -213,7 +213,7 @@ Get the extras for this session. - To be added. + The extras for this session. Get the extras for this session. diff --git a/docs/xml/Android.Media.Session/MediaPlaybackType.xml b/docs/xml/Android.Media.Session/MediaPlaybackType.xml index 7d0b3699d..f72653fbd 100644 --- a/docs/xml/Android.Media.Session/MediaPlaybackType.xml +++ b/docs/xml/Android.Media.Session/MediaPlaybackType.xml @@ -38,7 +38,7 @@ 1 - To be added. + The session uses local playback. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -65,7 +65,7 @@ 2 - To be added. + The session uses remote playback. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. diff --git a/docs/xml/Android.Media.Session/MediaSessionFlags.xml b/docs/xml/Android.Media.Session/MediaSessionFlags.xml index ada8a12d4..1b4be8ca1 100644 --- a/docs/xml/Android.Media.Session/MediaSessionFlags.xml +++ b/docs/xml/Android.Media.Session/MediaSessionFlags.xml @@ -44,7 +44,7 @@ 1 - To be added. + Indicates that the session can handle media button events. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -71,7 +71,7 @@ 2 - To be added. + Indicates that the session handles transport control commands through its callback. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. From 4f0063bfe19cfd3965f37f379afaf643ad407407 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Sun, 16 Aug 2026 09:48:27 -0500 Subject: [PATCH 2/4] Clarify nullable MediaController extras Refs #137 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- docs/xml/Android.Media.Session/MediaController.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/xml/Android.Media.Session/MediaController.xml b/docs/xml/Android.Media.Session/MediaController.xml index f25e54361..a1115fe75 100644 --- a/docs/xml/Android.Media.Session/MediaController.xml +++ b/docs/xml/Android.Media.Session/MediaController.xml @@ -213,7 +213,7 @@ Get the extras for this session. - The extras for this session. + The extras for this session, or null if none are set. Get the extras for this session. From bbb40d0fb60020a5277e4bcc6d4e725b35370c2d Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Tue, 18 Aug 2026 09:03:47 -0500 Subject: [PATCH 3/4] Address media session review feedback Correct PlaybackInfo.PlaybackType to use the session playback enum and document that the legacy session flags are no-ops starting with API 26. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../MediaController+PlaybackInfo.xml | 8 ++++---- docs/xml/Android.Media.Session/MediaSessionFlags.xml | 4 ++-- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/xml/Android.Media.Session/MediaController+PlaybackInfo.xml b/docs/xml/Android.Media.Session/MediaController+PlaybackInfo.xml index 05c83adeb..998e6a68a 100644 --- a/docs/xml/Android.Media.Session/MediaController+PlaybackInfo.xml +++ b/docs/xml/Android.Media.Session/MediaController+PlaybackInfo.xml @@ -267,10 +267,10 @@ - - + + - + Property Mono.Android @@ -283,7 +283,7 @@ - Android.Media.MediaPlaybackType + Android.Media.Session.MediaPlaybackType Get the type of playback which affects volume handling. diff --git a/docs/xml/Android.Media.Session/MediaSessionFlags.xml b/docs/xml/Android.Media.Session/MediaSessionFlags.xml index 1b4be8ca1..3b5da7a71 100644 --- a/docs/xml/Android.Media.Session/MediaSessionFlags.xml +++ b/docs/xml/Android.Media.Session/MediaSessionFlags.xml @@ -44,7 +44,7 @@ 1 - Indicates that the session can handle media button events. + Indicates that the session can handle media button events. This flag is a no-op on Android 8.0 (API level 26) and later, where all media sessions are expected to handle media button events. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -71,7 +71,7 @@ 2 - Indicates that the session handles transport control commands through its callback. + Indicates that the session handles transport control commands through its callback. This flag is a no-op on Android 8.0 (API level 26) and later, where all media sessions are expected to handle transport controls. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. From 361dde7d0aedef28aa270e68b65ed10918d503b0 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Tue, 18 Aug 2026 11:47:48 -0500 Subject: [PATCH 4/4] Preserve shipping playback signature Retain the generated PlaybackInfo.PlaybackType metadata from the shipping managed reference assembly until the upstream binding correction ships. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: af23b1a9-3cb5-4a1d-ad0b-bddd4be609e5 --- .../MediaController+PlaybackInfo.xml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/xml/Android.Media.Session/MediaController+PlaybackInfo.xml b/docs/xml/Android.Media.Session/MediaController+PlaybackInfo.xml index 998e6a68a..05c83adeb 100644 --- a/docs/xml/Android.Media.Session/MediaController+PlaybackInfo.xml +++ b/docs/xml/Android.Media.Session/MediaController+PlaybackInfo.xml @@ -267,10 +267,10 @@ - - + + - + Property Mono.Android @@ -283,7 +283,7 @@ - Android.Media.Session.MediaPlaybackType + Android.Media.MediaPlaybackType Get the type of playback which affects volume handling.