1# Audio Playback Stream Management
2
3An audio playback application must notice audio stream state changes and perform corresponding operations. For example, when detecting that an audio stream is being played or paused, the application must change the UI display of the **Play** button.
4
5## Reading or Listening for Audio Stream State Changes in the Application
6
7Create an AudioRenderer by referring to [Using AudioRenderer for Audio Playback](using-audiorenderer-for-playback.md) or [audio.createAudioRenderer](../../reference/apis-audio-kit/js-apis-audio.md#audiocreateaudiorenderer8). Then obtain the audio stream state changes in either of the following ways:
8
9- Check the [state](../../reference/apis-audio-kit/js-apis-audio.md#attributes) of the AudioRenderer.
10
11  ```ts
12  import { audio } from '@kit.AudioKit';
13
14  let audioRendererState: audio.AudioState = audioRenderer.state;
15  console.info(`Current state is: ${audioRendererState }`)
16  ```
17
18- Register **stateChange** to listen for state changes of the AudioRenderer.
19
20  ```ts
21  import { audio } from '@kit.AudioKit';
22
23  audioRenderer.on('stateChange', (rendererState: audio.AudioState) => {
24    console.info(`State change to: ${rendererState}`)
25  });
26  ```
27
28The application then performs an operation, for example, changing the display of the **Play** button, by comparing the obtained state with [AudioState](../../reference/apis-audio-kit/js-apis-audio.md#audiostate8).
29
30## Reading or Listening for Changes in All Audio Streams
31
32If an application needs to obtain the change information about all audio streams, it can use **AudioStreamManager** to read or listen for the changes of all audio streams.
33
34<!--Del-->
35> **NOTE**
36>
37> The audio stream change information marked as the system API can be viewed only by system applications.
38<!--DelEnd-->
39
40The figure below shows the call relationship of audio stream management.
41
42![Call relationship of audio stream management](figures/audio-stream-mgmt-invoking-relationship.png)
43
44During application development, first use **getStreamManager()** to create an **AudioStreamManager** instance. Then call **on('audioRendererChange')** to listen for audio stream changes and obtain a notification when the audio stream state or device changes. To cancel the listening for these changes, call **off('audioRendererChange')**. You can also call **getCurrentAudioRendererInfoArray()** to obtain information such as the unique ID of the playback stream, UID of the playback stream client, and stream status.
45
46For details about the APIs, see [AudioStreamManager](../../reference/apis-audio-kit/js-apis-audio.md#audiostreammanager9).
47
48## How to Develop
49
501. Create an **AudioStreamManager** instance.
51
52   Before using **AudioStreamManager** APIs, you must use **getStreamManager()** to create an **AudioStreamManager** instance.
53
54   ```ts
55   import { audio } from '@kit.AudioKit';
56
57   let audioManager = audio.getAudioManager();
58   let audioStreamManager = audioManager.getStreamManager();
59   ```
60
612. Use **on('audioRendererChange')** to listen for audio playback stream changes. If the application needs to receive a notification when the audio playback stream state or device changes, it can subscribe to this event.
62
63   ```ts
64   import { audio } from '@kit.AudioKit';
65
66   audioStreamManager.on('audioRendererChange',  (AudioRendererChangeInfoArray: audio.AudioRendererChangeInfoArray) => {
67     for (let i = 0; i < AudioRendererChangeInfoArray.length; i++) {
68       let AudioRendererChangeInfo = AudioRendererChangeInfoArray[i];
69       console.info(`## RendererChange on is called for ${i} ##`);
70       console.info(`StreamId for ${i} is: ${AudioRendererChangeInfo.streamId}`);
71       console.info(`Content ${i} is: ${AudioRendererChangeInfo.rendererInfo.content}`);
72       console.info(`Stream ${i} is: ${AudioRendererChangeInfo.rendererInfo.usage}`);
73       console.info(`Flag ${i} is: ${AudioRendererChangeInfo.rendererInfo.rendererFlags}`);
74       for (let j = 0;j < AudioRendererChangeInfo.deviceDescriptors.length; j++) {
75         console.info(`Id: ${i} : ${AudioRendererChangeInfo.deviceDescriptors[j].id}`);
76         console.info(`Type: ${i} : ${AudioRendererChangeInfo.deviceDescriptors[j].deviceType}`);
77         console.info(`Role: ${i} : ${AudioRendererChangeInfo.deviceDescriptors[j].deviceRole}`);
78         console.info(`Name: ${i} : ${AudioRendererChangeInfo.deviceDescriptors[j].name}`);
79         console.info(`Address: ${i} : ${AudioRendererChangeInfo.deviceDescriptors[j].address}`);
80         console.info(`SampleRates: ${i} : ${AudioRendererChangeInfo.deviceDescriptors[j].sampleRates[0]}`);
81         console.info(`ChannelCount ${i} : ${AudioRendererChangeInfo.deviceDescriptors[j].channelCounts[0]}`);
82         console.info(`ChannelMask: ${i} : ${AudioRendererChangeInfo.deviceDescriptors[j].channelMasks}`);
83       }
84     }
85   });
86   ```
87
883. (Optional) Use **off('audioRendererChange')** to cancel listening for audio playback stream changes.
89
90   ```ts
91   audioStreamManager.off('audioRendererChange');
92   console.info('RendererChange Off is called ');
93   ```
94
954. (Optional) Call **getCurrentAudioRendererInfoArray()** to obtain the information about all audio playback streams.
96
97     This API can be used to obtain the unique ID of the audio playback stream, UID of the audio playback client, audio status, and other information about the audio player.
98   > **NOTE**
99   >
100   > Before listening for state changes of all audio streams, the application must [declare the ohos.permission.USE_BLUETOOTH permission](../../security/AccessToken/declare-permissions.md), for the device name and device address (Bluetooth related attributes) to be displayed correctly.
101
102   ```ts
103   import { audio } from '@kit.AudioKit';
104   import { BusinessError } from '@kit.BasicServicesKit';
105
106   async function getCurrentAudioRendererInfoArray(): Promise<void> {
107     await audioStreamManager.getCurrentAudioRendererInfoArray().then((AudioRendererChangeInfoArray: audio.AudioRendererChangeInfoArray) => {
108       console.info(`getCurrentAudioRendererInfoArray  Get Promise is called `);
109       if (AudioRendererChangeInfoArray != null) {
110         for (let i = 0; i < AudioRendererChangeInfoArray.length; i++) {
111           let AudioRendererChangeInfo = AudioRendererChangeInfoArray[i];
112           console.info(`StreamId for ${i} is: ${AudioRendererChangeInfo.streamId}`);
113           console.info(`Content ${i} is: ${AudioRendererChangeInfo.rendererInfo.content}`);
114           console.info(`Stream ${i} is: ${AudioRendererChangeInfo.rendererInfo.usage}`);
115           console.info(`Flag ${i} is: ${AudioRendererChangeInfo.rendererInfo.rendererFlags}`);
116           for (let j = 0;j < AudioRendererChangeInfo.deviceDescriptors.length; j++) {
117             console.info(`Id: ${i} : ${AudioRendererChangeInfo.deviceDescriptors[j].id}`);
118             console.info(`Type: ${i} : ${AudioRendererChangeInfo.deviceDescriptors[j].deviceType}`);
119             console.info(`Role: ${i} : ${AudioRendererChangeInfo.deviceDescriptors[j].deviceRole}`);
120             console.info(`Name: ${i} : ${AudioRendererChangeInfo.deviceDescriptors[j].name}`);
121             console.info(`Address: ${i} : ${AudioRendererChangeInfo.deviceDescriptors[j].address}`);
122             console.info(`SampleRates: ${i} : ${AudioRendererChangeInfo.deviceDescriptors[j].sampleRates[0]}`);
123             console.info(`ChannelCount ${i} : ${AudioRendererChangeInfo.deviceDescriptors[j].channelCounts[0]}`);
124             console.info(`ChannelMask: ${i} : ${AudioRendererChangeInfo.deviceDescriptors[j].channelMasks}`);
125           }
126         }
127       }
128     }).catch((err: BusinessError ) => {
129       console.error(`Invoke getCurrentAudioRendererInfoArray failed, code is ${err.code}, message is ${err.message}`);
130     });
131   }
132   ```
133