1# Media Subsystem Changelog
2
3## cl.multimedia.1 AudioSpatializationManager APIs in @ohos.multimedia.audio for Querying, Setting, and Listening for Spatial Audio and Head Tracking Status Are Deprecated
4
5**Access Level**
6
7System API
8
9**Reason for Change**
10
11The 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.
12
13**Change Impact**
14
15This change is a non-compatible change.
16
17When you use the old APIs, a message is displayed, indicating that they are deprecated. You are advised to use the substitute APIs.
18
19**Change Since**
20
21OpenHarmony SDK 5.0.0.36
22
23**Deprecated APIs/Components**
24
25|         Deprecated API         |           Substitute API           |
26| :----------------------------: | :---------------------------: |
27| audio.AudioSpatializationManager#setSpatializationEnabled(enable: boolean, callback: AsyncCallback\<void>): void | audio.AudioSpatializationManager#setSpatializationEnabled(deviceDescriptor: AudioDeviceDescriptor, enabled: boolean): Promise\<void> |
28| audio.AudioSpatializationManager#setSpatializationEnabled(enable: boolean): Promise\<void> | audio.AudioSpatializationManager#setSpatializationEnabled(deviceDescriptor: AudioDeviceDescriptor, enabled: boolean): Promise\<void> |
29| audio.AudioSpatializationManager#isSpatializationEnabled(): boolean | audio.AudioSpatializationManager#isSpatializationEnabled(deviceDescriptor: AudioDeviceDescriptor): boolean |
30| audio.AudioSpatializationManager#on(type: 'spatializationEnabledChange', callback: Callback\<boolean>): void | audio.AudioSpatializationManager#on(type: 'spatializationEnabledChangeForAnyDevice', callback: Callback\<AudioSpatialEnabledStateForDevice>): void |
31| audio.AudioSpatializationManager#off(type: 'spatializationEnabledChange', callback?: Callback\<boolean>): void | audio.AudioSpatializationManager#off(type: 'spatializationEnabledChangeForAnyDevice', callback?: Callback\<AudioSpatialEnabledStateForDevice>): void |
32| audio.AudioSpatializationManager#setHeadTrackingEnabled(enable: boolean, callback: AsyncCallback\<void>): void | audio.AudioSpatializationManager#setHeadTrackingEnabled(deviceDescriptor: AudioDeviceDescriptor, enabled: boolean): Promise\<void> |
33| audio.AudioSpatializationManager#setHeadTrackingEnabled(enable: boolean): Promise\<void> | audio.AudioSpatializationManager#setHeadTrackingEnabled(deviceDescriptor: AudioDeviceDescriptor, enabled: boolean): Promise\<void> |
34| audio.AudioSpatializationManager#isHeadTrackingEnabled(): boolean | audio.AudioSpatializationManager#isHeadTrackingEnabled(deviceDescriptor: AudioDeviceDescriptor): boolean |
35| audio.AudioSpatializationManager#on(type: 'headTrackingEnabledChange', callback: Callback\<boolean>): void | audio.AudioSpatializationManager#on(type: 'headTrackingEnabledChangeForAnyDevice', callback: Callback\<AudioSpatialEnabledStateForDevice>): void |
36| audio.AudioSpatializationManager#off(type: 'headTrackingEnabledChange', callback?: Callback\<boolean>): void | audio.AudioSpatializationManager#off(type: 'headTrackingEnabledChangeForAnyDevice', callback?: Callback\<AudioSpatialEnabledStateForDevice>): void |
37
38**Adaptation Guide**
39
40Replace the old APIs in the code with the new APIs.
41