Merge branch 'google:main' into tap2tone

Author: hasinur010

samples/README.md

@@ -12,6 +12,8 @@ There is an associated codelab to follow along with. (Java)
 1. [LiveEffect](LiveEffect): Loops audio from input stream to output stream to demonstrate duplex capability. (Java)
 1. [SoundBoard](SoundBoard): A 25 to 40 note dynamic synthesizer, demonstating combining signals. The stream restarts
 when the display rotates. (Kotlin)
+1. [OboeDJ](OboeDJ): A high-performance DJ app with two independent playback decks and real-time scratching. (Kotlin/Compose)
+1. [PowerPlay](powerplay): Demonstrates power-efficient audio features like PCM Offload and automation via ADB. (Kotlin/Compose)
 
 Pre-requisites
 -------------

samples/powerplay/.gitignore

@@ -1,3 +1,32 @@
-# PowerPlay
+# PowerPlay Sample
 
-TBD
+An energy-efficient audio player sample application demonstrating the use of the Performance Modes in Oboe library. It showcases different audio performance modes, including low-latency, power-saving, and hardware PCM offload, wrapped in a modern Jetpack Compose UI.
+
+## Features
+-   **Performance Modes**: Switch between None, Low Latency, Power Saving, and hardware PCM Offload playback modes.
+-   **PCM Offload**: Support for hardware PCM Offloaded playback to dramatically reduce power consumption for continuous playback.
+-   **Audio API Selection**: Toggle between MMAP and Classic audio pathways.
+-   **Dynamic Playback**: Play bundled audio tracks or load custom local WAV files from your device.
+-   **Intent Automation**: Support for automation via ADB intents to control playback, modes, and configurations programmatically.
+-   **Foreground Service**: Ensures uninterrupted audio playback while the app is in the background or the screen is off.
+
+## UI Overview
+-   **Play/Pause Button**: Controls playback for the current track.
+-   **Seek Bar**: Adjust the current playback position. Only available in non-offload modes.
+-   **Settings Bottom Sheet**: Configure performance modes (Low Latency, Power Saving, PCM Offload), adjust requested buffer size in frames, and toggle MMAP.
+-   **Info Dialog**: View details about the current audio mode, WAV file properties (Sample Rate, Channels, Bit Depth, Duration), and actual buffer size.
+-   **Add Local File**: Load custom WAV files directly from your device storage to add to your queue.
+
+## Technical Details
+-   **Engine**: C++ `PowerPlayMultiPlayer` managing Oboe streams, buffer sizing, and performance configurations.
+-   **Audio Format**: Uses Float PCM audio encoding with stereo output.
+-   **Automation**: `IntentBasedTestSupport` allows programmatic control via Android Intents for robust testing. For more information, see the [Automation Guide](QuickStart_Automation.md).
+-   **State Management**: Jetpack Compose manages the UI states and synchronizes them with the underlying C++ audio engine.
+
+Images
+-----------
+<p align="center">
+  <img src="images/powerplay_image1.png" alt="powerplay_image1" width="250"/>
+  <img src="images/powerplay_image2.png" alt="powerplay_image2" width="250"/>
+  <img src="images/powerplay_image3.png" alt="powerplay_image3" width="250"/>
+</p>