1e41f4b71Sopenharmony_ci# Media Subsystem Changelog
2e41f4b71Sopenharmony_ci
3e41f4b71Sopenharmony_ci## cl.multimedia.1 AudioSpatializationManager APIs in @ohos.multimedia.audio for Querying, Setting, and Listening for Spatial Audio and Head Tracking Status Are Deprecated
4e41f4b71Sopenharmony_ci
5e41f4b71Sopenharmony_ci**Access Level**
6e41f4b71Sopenharmony_ci
7e41f4b71Sopenharmony_ciSystem API
8e41f4b71Sopenharmony_ci
9e41f4b71Sopenharmony_ci**Reason for Change**
10e41f4b71Sopenharmony_ci
11e41f4b71Sopenharmony_ciThe service feature is changed. Previously, the APIs for querying, setting, and listening for the status of spatial audio and head tracking do not contain a device parameter, so that you cannot use the APIs for a specified device. The new APIs introduce a device parameter. To match new service features, you are not advised to use the old APIs.
12e41f4b71Sopenharmony_ci
13e41f4b71Sopenharmony_ci**Change Impact**
14e41f4b71Sopenharmony_ci
15e41f4b71Sopenharmony_ciThis change is a non-compatible change.
16e41f4b71Sopenharmony_ci
17e41f4b71Sopenharmony_ciWhen you use the old APIs, a message is displayed, indicating that they are deprecated. You are advised to use the substitute APIs.
18e41f4b71Sopenharmony_ci
19e41f4b71Sopenharmony_ci**Change Since**
20e41f4b71Sopenharmony_ci
21e41f4b71Sopenharmony_ciOpenHarmony SDK 5.0.0.36
22e41f4b71Sopenharmony_ci
23e41f4b71Sopenharmony_ci**Deprecated APIs/Components**
24e41f4b71Sopenharmony_ci
25e41f4b71Sopenharmony_ci|         Deprecated API         |           Substitute API           |
26e41f4b71Sopenharmony_ci| :----------------------------: | :---------------------------: |
27e41f4b71Sopenharmony_ci| audio.AudioSpatializationManager#setSpatializationEnabled(enable: boolean, callback: AsyncCallback\<void>): void | audio.AudioSpatializationManager#setSpatializationEnabled(deviceDescriptor: AudioDeviceDescriptor, enabled: boolean): Promise\<void> |
28e41f4b71Sopenharmony_ci| audio.AudioSpatializationManager#setSpatializationEnabled(enable: boolean): Promise\<void> | audio.AudioSpatializationManager#setSpatializationEnabled(deviceDescriptor: AudioDeviceDescriptor, enabled: boolean): Promise\<void> |
29e41f4b71Sopenharmony_ci| audio.AudioSpatializationManager#isSpatializationEnabled(): boolean | audio.AudioSpatializationManager#isSpatializationEnabled(deviceDescriptor: AudioDeviceDescriptor): boolean |
30e41f4b71Sopenharmony_ci| audio.AudioSpatializationManager#on(type: 'spatializationEnabledChange', callback: Callback\<boolean>): void | audio.AudioSpatializationManager#on(type: 'spatializationEnabledChangeForAnyDevice', callback: Callback\<AudioSpatialEnabledStateForDevice>): void |
31e41f4b71Sopenharmony_ci| audio.AudioSpatializationManager#off(type: 'spatializationEnabledChange', callback?: Callback\<boolean>): void | audio.AudioSpatializationManager#off(type: 'spatializationEnabledChangeForAnyDevice', callback?: Callback\<AudioSpatialEnabledStateForDevice>): void |
32e41f4b71Sopenharmony_ci| audio.AudioSpatializationManager#setHeadTrackingEnabled(enable: boolean, callback: AsyncCallback\<void>): void | audio.AudioSpatializationManager#setHeadTrackingEnabled(deviceDescriptor: AudioDeviceDescriptor, enabled: boolean): Promise\<void> |
33e41f4b71Sopenharmony_ci| audio.AudioSpatializationManager#setHeadTrackingEnabled(enable: boolean): Promise\<void> | audio.AudioSpatializationManager#setHeadTrackingEnabled(deviceDescriptor: AudioDeviceDescriptor, enabled: boolean): Promise\<void> |
34e41f4b71Sopenharmony_ci| audio.AudioSpatializationManager#isHeadTrackingEnabled(): boolean | audio.AudioSpatializationManager#isHeadTrackingEnabled(deviceDescriptor: AudioDeviceDescriptor): boolean |
35e41f4b71Sopenharmony_ci| audio.AudioSpatializationManager#on(type: 'headTrackingEnabledChange', callback: Callback\<boolean>): void | audio.AudioSpatializationManager#on(type: 'headTrackingEnabledChangeForAnyDevice', callback: Callback\<AudioSpatialEnabledStateForDevice>): void |
36e41f4b71Sopenharmony_ci| audio.AudioSpatializationManager#off(type: 'headTrackingEnabledChange', callback?: Callback\<boolean>): void | audio.AudioSpatializationManager#off(type: 'headTrackingEnabledChangeForAnyDevice', callback?: Callback\<AudioSpatialEnabledStateForDevice>): void |
37e41f4b71Sopenharmony_ci
38e41f4b71Sopenharmony_ci**Adaptation Guide**
39e41f4b71Sopenharmony_ci
40e41f4b71Sopenharmony_ciReplace the old APIs in the code with the new APIs.
41