From 704c079dcf43ef700ffce86c28e8eb51ac6f0dcb Mon Sep 17 00:00:00 2001
From: cailei <cailei24@huawei.com>
Date: Fri, 20 Jun 2025 15:14:17 +0800
Subject: [PATCH] =?UTF-8?q?=E5=A2=9E=E5=8A=A0=E5=B8=A6Drain=E6=92=AD?=
 =?UTF-8?q?=E6=94=BE=E7=BB=93=E6=9D=9F=E5=9B=9E=E8=B0=83=E6=8E=A5=E5=8F=A3?=
 =?UTF-8?q?=E4=B8=8E=E4=BD=8E=E5=8A=9F=E8=80=97=E5=BC=80=E5=85=B3=E4=B8=8E?=
 =?UTF-8?q?=E7=8A=B6=E6=80=81=E6=8E=A5=E5=8F=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: cailei <cailei24@huawei.com>
---
 api/@ohos.multimedia.audio.d.ts | 91 +++++++++++++++++++++++++++++++++
 1 file changed, 91 insertions(+)

diff --git a/api/@ohos.multimedia.audio.d.ts b/api/@ohos.multimedia.audio.d.ts
index ed1c4cdcda..1e5ca1b8d2 100644
--- a/api/@ohos.multimedia.audio.d.ts
+++ b/api/@ohos.multimedia.audio.d.ts
@@ -2033,6 +2033,13 @@ declare namespace audio {
      * @since 19
      */
     volumeMode?: AudioVolumeMode;
+    /**
+     * Stream power mode. Default use {@link StreamPowerMode.STTREAM_POWER_SAVING}.
+     * @type { ?StreamPowerMode }
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 20
+     */
+    powerMode?: StreamPowerMode;
   }
 
   /**
@@ -8777,6 +8784,67 @@ declare namespace audio {
      * @since 12
      */
     off(type: 'writeData', callback?: AudioRendererWriteDataCallback): void;
+
+    /**
+     * Gets audio renderer running status, check if it works in power saving status.
+     * @returns { Promise<StreamPowerMode> } Promise used to return the power status.
+     * @throws { BusinessError } 6800103 - Operation not permit at current state.
+     * @syscap SystemCapability.Multimedia.Audio.Renderer
+     * @since 20
+     */
+    getPowerStatus(): Promise<StreamPowerMode>;
+
+    /**
+     * Subscribes to stream power status changes.
+     * @param { 'powerStatusChange' } type Type of the event to listen for.
+     * Only the powerStatusChange event is supported.
+     * @param { Callback<StreamPowerMode> } callback Callback used to return the power status
+     * change event.
+     * @throws  { BusinessError } 6800101 - Parameter verification failed.
+     * @syscap SystemCapability.Multimedia.Audio.Renderer
+     * @since 20
+     */
+    on(type: 'powerStatusChange', callback: Callback<StreamPowerMode>): void;
+
+    /**
+     * Unsubscribes stream power status change event callback.
+     * @param { 'powerStatusChange' } type - Type of the event to listen for.
+     * @param { Callback<StreamPowerMode> } callback - Callback used to listen for the power status
+     * change event.
+     * @throws  { BusinessError } 6800101 - Parameter verification failed.
+     * @syscap SystemCapability.Multimedia.Audio.Renderer
+     * @since 20
+     */
+    off(type: 'powerStatusChange', callback?: Callback<StreamPowerMode>): void;
+
+    /**
+     * Stops rendering and drains the playback buffer. This method uses a promise to return the result.
+     * @returns { Promise<void> } Promise used to return the result.
+     * @throws { BusinessError } 6800103 - Operation not permit at current state.
+     * @syscap SystemCapability.Multimedia.Audio.Renderer
+     * @since 20
+     */
+    stopWithDrain(): Promise<void>;
+
+    /**
+     * Subscribes to playback completed event callback. Use only with stopWithDrain function.
+     * @param { 'completed' } type - Type of the event to listen for. Only the completed event is supported.
+     * @param { Callback<void> } callback - Callback used to listen for the playback completed.
+     * @throws  { BusinessError } 6800101 - Parameter verification failed.
+     * @syscap SystemCapability.Multimedia.Audio.Renderer
+     * @since 20
+     */
+    on(type: 'completed', callback: Callback<void>): void;
+
+    /**
+     * Unsubscribes to playback completed event callback. Use only with stopWithDrain function.
+     * @param { 'completed' } type - Type of the event to listen for.
+     * @param { Callback<void> } callback - Callback used to listen for the playback completed.
+     * @throws  { BusinessError } 6800101 - Parameter verification failed.
+     * @syscap SystemCapability.Multimedia.Audio.Renderer
+     * @since 20
+     */
+    off(type: 'completed', callback?: Callback<void>): void;
   }
 
   /**
@@ -11314,6 +11382,29 @@ declare namespace audio {
      */
     enable(enable: boolean): Promise<boolean>;
   }
+
+  /**
+   * Enumerates stream power mode.
+   * @enum { number }
+   * @syscap SystemCapability.Multimedia.Audio.Core
+   * @since 20
+   */
+  enum StreamPowerMode {
+    /**
+     * The power saving.
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 20
+     */
+    STTREAM_POWER_SAVING = 0,
+
+    /**
+     * The power normal.
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @systemapi
+     * @since 20
+     */
+    STTREAM_POWER_NORMAL = 1
+  }
 }
 
 export default audio;
-- 
Gitee