!7980 空间音频新增接口

Merge pull request !7980 from chongteng wang/master

api/@ohos.multimedia.audio.d.ts

@@ -599,7 +599,73 @@ declare namespace audio {
      * @syscap SystemCapability.Multimedia.Audio.Core
      * @since 8
      */
-    CHANNEL_2 = 0x1 << 1
+    CHANNEL_2 = 0x1 << 1,
+    /**
+     * Channel 3.
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CHANNEL_3 = 3,
+    /**
+     * Channel 4.
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CHANNEL_4 = 4,
+    /**
+     * Channel 5.
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CHANNEL_5 = 5,
+    /**
+     * Channel 6.
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CHANNEL_6 = 6,
+    /**
+     * Channel 7.
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CHANNEL_7 = 7,
+    /**
+     * Channel 8.
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CHANNEL_8 = 8,
+    /**
+     * Channel 9.
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CHANNEL_9 = 9,
+    /**
+     * Channel 10.
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CHANNEL_10 = 10,
+    /**
+     * Channel 12.
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CHANNEL_12 = 12,
+    /**
+     * Channel 14.
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CHANNEL_14 = 14,
+    /**
+     * Channel 16.
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CHANNEL_16 = 16
   }
 
   /**
@@ -939,6 +1005,13 @@ declare namespace audio {
      * @since 8
      */
     encodingType: AudioEncodingType;
+    /**
+     * Audio channel layout.
+     * @type { ?AudioChannelLayout }
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    channelLayout?: AudioChannelLayout;
   }
 
   /**
@@ -1804,6 +1877,16 @@ declare namespace audio {
      * @since 9
      */
     getRoutingManager(): AudioRoutingManager;
+
+    /**
+     * Obtains an {@link AudioSpatializationManager} instance.
+     * @returns { AudioSpatializationManager } AudioSpatializationManager instance.
+     * @throws { BusinessError } 202 - Not system App.
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    getSpatializationManager(): AudioSpatializationManager;
   }
 
   /**
@@ -2797,6 +2880,195 @@ declare namespace audio {
     getSystemVolumeInDbSync(volumeType: AudioVolumeType, volumeLevel: number, device: DeviceType): number;
   }
 
+  /**
+   * Implements audio spatialization management.
+   * @typedef AudioSpatializationManager
+   * @syscap SystemCapability.Multimedia.Audio.Spatialization
+   * @systemapi
+   * @since 11
+   */
+  interface AudioSpatializationManager {
+    /**
+     * Checks whether spatialization is supported by system.
+     * @returns { boolean } Whether spatialization is supported by system.
+     * @throws { BusinessError } 202 - Not system App.
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    isSpatializationSupported(): boolean;
+
+    /**
+     * Checks whether spatialization is supported by the specified device.
+     * @param { AudioDeviceDescriptor } deviceDescriptor - Audio device description.
+     * @returns { boolean } Whether spatialization is supported by the specified device.
+     * @throws { BusinessError } 202 - Not system App.
+     * @throws { BusinessError } 401 - Input parameter type or number mismatch.
+     * @throws { BusinessError } 6800101 - Invalid parameter error.
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    isSpatializationSupportedForDevice(deviceDescriptor: AudioDeviceDescriptor): boolean;
+
+    /**
+     * Checks whether head tracking is supported by system.
+     * @returns { boolean } Whether head tracking is supported by system.
+     * @throws { BusinessError } 202 - Not system App.
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    isHeadTrackingSupported(): boolean;
+
+    /**
+     * Checks whether head tracking is supported by the specified device.
+     * @param { AudioDeviceDescriptor } deviceDescriptor - Audio device description.
+     * @returns { boolean } Whether head tracking is supported by the specified device.
+     * @throws { BusinessError } 202 - Not system App.
+     * @throws { BusinessError } 401 - Input parameter type or number mismatch.
+     * @throws { BusinessError } 6800101 - Invalid parameter error.
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    isHeadTrackingSupportedForDevice(deviceDescriptor: AudioDeviceDescriptor): boolean;
+
+    /**
+     * Sets the spatialization enabled or disabled. This method uses an asynchronous callback to return the result.
+     * @param { boolean } enable - Spatialization enable state.
+     * @param { AsyncCallback<void> } callback - Callback used to return the result.
+     * @throws { BusinessError } 202 - Not system App.
+     * @throws { BusinessError } 401 - Input parameter type or number mismatch.
+     * @throws { BusinessError } 6800101 - Invalid parameter error.
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    setSpatializationEnabled(enable: boolean, callback: AsyncCallback<void>): void;
+    /**
+     * Sets the spatialization enabled or disabled. This method uses a promise to return the result.
+     * @param { boolean } enable - Spatialization enable state.
+     * @returns { Promise<void> } Promise used to return the result.
+     * @throws { BusinessError } 202 - Not system App.
+     * @throws { BusinessError } 401 - Input parameter type or number mismatch.
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    setSpatializationEnabled(enable: boolean): Promise<void>;
+
+    /**
+     * Checks whether the spatialization is enabled.
+     * @returns { boolean } Whether the spatialization is enabled.
+     * @throws { BusinessError } 202 - Not system App.
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    isSpatializationEnabled(): boolean;
+
+    /**
+     * Subscribes to the spatialization enable state change events. When the spatialization enable state changes,
+     * registered clients will receive the callback.
+     * @param { 'spatializationEnabledChange' } type - Type of the event to listen for.
+     * @param { Callback<boolean> } callback - Callback used to get the spatialization enable state.
+     * @throws { BusinessError } 202 - Not system App.
+     * @throws { BusinessError } 401 - Input parameter type or number mismatch.
+     * @throws { BusinessError } 6800101 - Invalid parameter error.
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    on(type: 'spatializationEnabledChange', callback: Callback<boolean>): void;
+
+    /**
+     * Unsubscribes to the spatialization enable state change events.
+     * @param { 'spatializationEnabledChange' } type - Type of the event to listen for.
+     * @param { Callback<boolean> } callback - Callback used to get the spatialization enable state.
+     * @throws { BusinessError } 202 - Not system App.
+     * @throws { BusinessError } 401 - Input parameter type or number mismatch.
+     * @throws { BusinessError } 6800101 - Invalid parameter error.
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    off(type: 'spatializationEnabledChange', callback?: Callback<boolean>): void;
+
+    /**
+     * Sets the head tracking enabled or disabled. This method uses an asynchronous callback to return the result.
+     * @param { boolean } enable - Head tracking enable state.
+     * @param { AsyncCallback<void> } callback - Callback used to return the result.
+     * @throws { BusinessError } 202 - Not system App.
+     * @throws { BusinessError } 401 - Input parameter type or number mismatch.
+     * @throws { BusinessError } 6800101 - Invalid parameter error.
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    setHeadTrackingEnabled(enable: boolean, callback: AsyncCallback<void>): void;
+    /**
+     * Sets the head tracking enabled or disabled. This method uses a promise to return the result.
+     * @param { boolean } enable - Head tracking enable state.
+     * @returns { Promise<void> } Promise used to return the result.
+     * @throws { BusinessError } 202 - Not system App.
+     * @throws { BusinessError } 401 - Input parameter type or number mismatch.
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    setHeadTrackingEnabled(enable: boolean): Promise<void>;
+
+    /**
+     * Checks whether the head tracking is enabled.
+     * @returns { boolean } Whether the head tracking is enabled.
+     * @throws { BusinessError } 202 - Not system App.
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    isHeadTrackingEnabled(): boolean;
+
+    /**
+     * Subscribes to the head tracking enable state change events. When the head tracking enable state changes,
+     * registered clients will receive the callback.
+     * @param { 'headTrackingEnabledChange' } type - Type of the event to listen for.
+     * @param { Callback<boolean> } callback - Callback used to get the head tracking enable state.
+     * @throws { BusinessError } 202 - Not system App.
+     * @throws { BusinessError } 401 - Input parameter type or number mismatch.
+     * @throws { BusinessError } 6800101 - Invalid parameter error.
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    on(type: 'headTrackingEnabledChange', callback: Callback<boolean>): void;
+
+    /**
+     * Unsubscribes to the head tracking enable state change events.
+     * @param { 'headTrackingEnabledChange' } type - Type of the event to listen for.
+     * @param { Callback<boolean> } callback - Callback used to get the head tracking enable state.
+     * @throws { BusinessError } 202 - Not system App.
+     * @throws { BusinessError } 401 - Input parameter type or number mismatch.
+     * @throws { BusinessError } 6800101 - Invalid parameter error.
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    off(type: 'headTrackingEnabledChange', callback?: Callback<boolean>): void;
+
+    /**
+     * Updates the spatial device state.
+     * @param { AudioSpatialDeviceState } spatialDeviceState - Spatial device state.
+     * @throws { BusinessError } 202 - Not system App.
+     * @throws { BusinessError } 401 - Input parameter type or number mismatch.
+     * @throws { BusinessError } 6800101 - Invalid parameter error.
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    updateSpatialDeviceState(spatialDeviceState: AudioSpatialDeviceState): void;
+  }
+
   /**
    * Describes an audio volume group.
    * @enum { number }
@@ -4582,6 +4854,455 @@ declare namespace audio {
      */
     EFFECT_DEFAULT = 1,
   }
+
+  /**
+   * Describes spatial device state.
+   * @typedef AudioSpatialDeviceState
+   * @syscap SystemCapability.Multimedia.Audio.Spatialization
+   * @systemapi
+   * @since 11
+   */
+  interface AudioSpatialDeviceState {
+    /**
+     * Spatial device address.
+     * @type { string }
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    address: string;
+
+    /**
+     * Whether the spatial device supports spatial rendering.
+     * @type { boolean }
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    isSpatializationSupported: boolean;
+
+    /**
+     * Whether the spatial device supports head tracking.
+     * @type { boolean }
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    isHeadTrackingSupported: boolean;
+
+    /**
+     * Spatial device type.
+     * @type { AudioSpatialDeviceType }
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    spatialDeviceType: AudioSpatialDeviceType;
+  }
+
+  /**
+   * Describes a spatial device type group.
+   * @enum { number }
+   * @syscap SystemCapability.Multimedia.Audio.Spatialization
+   * @systemapi
+   * @since 11
+   */
+  enum AudioSpatialDeviceType {
+    /**
+     * Audio Spatial Device Type none.
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    SPATIAL_DEVICE_TYPE_NONE = 0,
+    /**
+     * Audio Spatial Device Type in-ear headphone.
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    SPATIAL_DEVICE_TYPE_IN_EAR_HEADPHONE = 1,
+    /**
+     * Audio Spatial Device Type half-in-ear headphone.
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    SPATIAL_DEVICE_TYPE_HALF_IN_EAR_HEADPHONE = 2,
+    /**
+     * Audio Spatial Device Type over-ear headphone.
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    SPATIAL_DEVICE_TYPE_OVER_EAR_HEADPHONE = 3,
+    /**
+     * Audio Spatial Device Type glasses.
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    SPATIAL_DEVICE_TYPE_GLASSES = 4,
+    /**
+     * Audio Spatial Device Type others.
+     * @syscap SystemCapability.Multimedia.Audio.Spatialization
+     * @systemapi
+     * @since 11
+     */
+    SPATIAL_DEVICE_TYPE_OTHERS = 5,
+  }
+
+  /**
+   * Audio AudioChannel Layout
+   * A 64-bit integer indicates that the appearance and order of the speakers for recording or playback.
+   * @enum { number }
+   * @syscap SystemCapability.Multimedia.Audio.Core
+   * @since 11
+   */
+  enum AudioChannelLayout {
+    /**
+     * Unknown Channel Layout
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_UNKNOWN = 0x0,
+    /**
+     * Channel Layout For Mono, 1 channel in total
+     * Speaker layout: front center(FC)
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_MONO = 0x4,
+    /**
+     * Channel Layout For Stereo, 2 channels in total
+     * Speaker layout: front left(FL), front right(FR)
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_STEREO = 0x3,
+    /**
+     * Channel Layout For Stereo-Downmix, 2 channels in total
+     * Speaker layout: Stereo left, stereo right
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_STEREO_DOWNMIX = 0x60000000,
+    /**
+     * Channel Layout For 2.1, 3 channels in total
+     * Speaker layout: Stereo plus low-frequency effects(LFE)
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_2POINT1 = 0xB,
+    /**
+     * Channel Layout For 3.0, 3 channels in total
+     * Speaker layout: Stereo plus back center(BC)
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_3POINT0 = 0x103,
+    /**
+     * Channel Layout For Surround, 3 channels in total
+     * Speaker layout: Stereo plus FC
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_SURROUND = 0x7,
+    /**
+     * Channel Layout For 3.1, 4 channels in total
+     * Speaker layout: Surround plus LFE
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_3POINT1 = 0xF,
+    /**
+     * Channel Layout For 4.0, 4 channels in total
+     * Speaker layout: Surround plus BC
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_4POINT0 = 0x107,
+    /**
+     * Channel Layout For Quad, 4 channels in total
+     * Speaker layout: Stereo plus left and right back speakers
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_QUAD = 0x33,
+    /**
+     * Channel Layout For Quad-Side, 4 channels in total
+     * Speaker layout: Stereo plus left and right side speakers(SL, SR)
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_QUAD_SIDE = 0x603,
+    /**
+     * Channel Layout For 2.0.2, 4 channels in total
+     * Speaker layout: Stereo plus left and right top side speakers
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_2POINT0POINT2 = 0x3000000003,
+    /**
+     * Channel Layout For ORDER1-ACN-N3D First Order Ambisonic(FOA), 4 channels in total
+     * First order, Ambisonic Channel Number(ACN) format, Normalization of three-D(N3D)
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_AMB_ORDER1_ACN_N3D = 0x100000000001,
+    /**
+     * Channel Layout For ORDER1-ACN-SN3D FOA, 4 channels in total
+     * First order, ACN format, Semi-Normalization of three-D(SN3D)
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_AMB_ORDER1_ACN_SN3D = 0x100000001001,
+    /**
+     * Channel Layout For ORDER1-FUMA FOA, 4 channels in total
+     * First order, Furse-Malham(FuMa) format
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_AMB_ORDER1_FUMA = 0x100000000101,
+    /**
+     * Channel Layout For 4.1, 5 channels in total
+     * Speaker layout: 4.0 plus LFE
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_4POINT1 = 0x10F,
+    /**
+     * Channel Layout For 5.0, 5 channels in total
+     * Speaker layout: Surround plus two side speakers
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_5POINT0 = 0x607,
+    /**
+     * Channel Layout For 5.0-Back, 5 channels in total
+     * Speaker layout: Surround plus two back speakers
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_5POINT0_BACK = 0x37,
+    /**
+     * Channel Layout For 2.1.2, 5 channels in total
+     * Speaker layout: 2.0.2 plus LFE
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_2POINT1POINT2 = 0x300000000B,
+    /**
+     * Channel Layout For 3.0.2, 5 channels in total
+     * Speaker layout: 2.0.2 plus FC
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_3POINT0POINT2 = 0x3000000007,
+    /**
+     * Channel Layout For 5.1, 6 channels in total
+     * Speaker layout: 5.0 plus LFE
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_5POINT1 = 0x60F,
+    /**
+     * Channel Layout For 5.1-Back, 6 channels in total
+     * Speaker layout: 5.0-Back plus LFE
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_5POINT1_BACK = 0x3F,
+    /**
+     * Channel Layout For 6.0, 6 channels in total
+     * Speaker layout: 5.0 plus BC
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_6POINT0 = 0x707,
+    /**
+     * Channel Layout For Hexagonal, 6 channels in total
+     * Speaker layout: 5.0-Back plus BC
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_HEXAGONAL = 0x137,
+    /**
+     * Channel Layout For 3.1.2, 6 channels in total
+     * Speaker layout: 3.1 plus two top front speakers(TFL, TFR)
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_3POINT1POINT2 = 0x500F,
+    /**
+     * Channel Layout For 6.0-Front, 6 channels in total
+     * Speaker layout: Quad-Side plus left and right front center speakers(FLC, FRC)
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_6POINT0_FRONT = 0x6C3,
+    /**
+     * Channel Layout For 6.1, 7 channels in total
+     * Speaker layout: 5.1 plus BC
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_6POINT1 = 0x70F,
+    /**
+     * Channel Layout For 6.1-Back, 7 channels in total
+     * Speaker layout: 5.1-Back plus BC
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_6POINT1_BACK = 0x13F,
+    /**
+     * Channel Layout For 6.1-Front, 7 channels in total
+     * Speaker layout: 6.0-Front plus LFE
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_6POINT1_FRONT = 0x6CB,
+    /**
+     * Channel Layout For 7.0, 7 channels in total
+     * Speaker layout: 5.0 plus two back speakers
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_7POINT0 = 0x637,
+    /**
+     * Channel Layout For 7.0-Front, 7 channels in total
+     * Speaker layout: 5.0 plus left and right front center speakers
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_7POINT0_FRONT = 0x6C7,
+    /**
+     * Channel Layout For 7.1, 8 channels in total
+     * Speaker layout: 5.1 plus two back speakers
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_7POINT1 = 0x63F,
+    /**
+     * Channel Layout For Octagonal, 8 channels in total
+     * Speaker layout: 5.0 plus BL, BR and BC.
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_OCTAGONAL = 0x737,
+    /**
+     * Channel Layout For 5.1.2, 8 channels in total
+     * Speaker layout: 5.1-Back plus two top side speakers.
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_5POINT1POINT2 = 0x300000060F,
+    /**
+     * Channel Layout For 7.1-Wide, 8 channels in total
+     * Speaker layout: 5.1 plus left and right front center speakers.
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_7POINT1_WIDE = 0x6CF,
+    /**
+     * Channel Layout For 7.1-Wide, 8 channels in total
+     * Speaker layout: 5.1-Back plus left and right front center speakers.
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_7POINT1_WIDE_BACK = 0xFF,
+    /**
+     * Channel Layout For ORDER2-ACN-N3D Higher Order Ambisonics(HOA), 9 channels in total
+     * Second order, ACN format, N3D
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_AMB_ORDER2_ACN_N3D = 0x100000000002,
+    /**
+     * Channel Layout For ORDER2-ACN-SN3D HOA, 9 channels in total
+     * Second order, ACN format, SN3D
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_AMB_ORDER2_ACN_SN3D = 0x100000001002,
+    /**
+     * Channel Layout For ORDER2-FUMA HOA, 9 channels in total
+     * Second order, FuMa format
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_AMB_ORDER2_FUMA = 0x100000000102,
+    /**
+     * Channel Layout For 5.1.4, 10 channels in total
+     * Speaker layout: 5.1 plus four top speakers(TFL, TFR, TBL, TBR)
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_5POINT1POINT4 = 0x2D60F,
+    /**
+     * Channel Layout For 7.1.2, 10 channels in total
+     * Speaker layout: 7.1 plus two top side speakers
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_7POINT1POINT2 = 0x300000063F,
+    /**
+     * Channel Layout For 7.1.4, 12 channels in total
+     * Speaker layout: 7.1 plus four top speakers
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_7POINT1POINT4 = 0x2D63F,
+    /**
+     * Channel Layout For 10.2, 12 channels in total
+     * Speaker layout: FL, FR, FC, TFL, TFR, BL, BR, BC, SL, SR, wide left(WL), and wide right(WR)
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_10POINT2 = 0x180005737,
+    /**
+     * Channel Layout For 9.1.4, 14 channels in total
+     * Speaker layout: 7.1.4 plus two wide speakers(WL, WR)
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_9POINT1POINT4 = 0x18002D63F,
+    /**
+     * Channel Layout For 9.1.6, 16 channels in total
+     * Speaker layout: 9.1.4 plus two top side speakers
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_9POINT1POINT6 = 0x318002D63F,
+    /**
+     * Channel Layout For Hexadecagonal, 16 channels in total
+     * Speaker layout: Octagonal plus two wide speakers, six top speakers(TFL, TFR, TFC, TBL, TBR, TBC)
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_HEXADECAGONAL = 0x18003F737,
+    /**
+     * Channel Layout For ORDER3-ACN-N3D HOA, 16 channels in total
+     * Third order, ACN format, N3D
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_AMB_ORDER3_ACN_N3D = 0x100000000003,
+    /**
+     * Channel Layout For ORDER3-ACN-SN3D HOA, 16 channels in total
+     * Third order, ACN format, N3D
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_AMB_ORDER3_ACN_SN3D = 0x100000001003,
+    /**
+     * Channel Layout For ORDER3-FUMA HOA, 16 channels in total
+     * Third order, FuMa format
+     * @syscap SystemCapability.Multimedia.Audio.Core
+     * @since 11
+     */
+    CH_LAYOUT_AMB_ORDER3_FUMA = 0x100000000103
+  }
 }
 
 export default audio;

api/device-define/default.json

@@ -220,6 +220,7 @@
     "SystemCapability.Print.PrintFramework",
     "SystemCapability.Multimedia.Media.AVScreenCapture",
     "SystemCapability.AI.IntelligentVoice.Core",
-    "SystemCapability.Multimedia.Media.SoundPool"
+    "SystemCapability.Multimedia.Media.SoundPool",
+    "SystemCapability.Multimedia.Audio.Spatialization"
   ]
 }

api/device-define/tablet.json

@@ -212,6 +212,7 @@
     "SystemCapability.Print.PrintFramework",
     "SystemCapability.Multimedia.Media.AVScreenCapture",
     "SystemCapability.Multimedia.Media.SoundPool",
-    "SystemCapability.Driver.ExternalDevice"
+    "SystemCapability.Driver.ExternalDevice",
+    "SystemCapability.Multimedia.Audio.Spatialization"
   ]
 }

build-tools/api_check_plugin/code_style_rule.json

@@ -342,7 +342,8 @@
       "SystemCapability.FileManagement.PhotoAccessHelper.Core",
       "SystemCapability.AI.IntelligentVoice.Core",
       "SystemCapability.Msdp.DeviceStatus.Drag",
-      "SystemCapability.DistributedDataManager.CommonType"
+      "SystemCapability.DistributedDataManager.CommonType",
+      "SystemCapability.Multimedia.Audio.Spatialization"
     ]
   },
   "administrators": [

build-tools/api_check_plugin/plugin/dictionaries_supplementary.txt

@@ -8,6 +8,7 @@ accelerates
 accents
 accommodates
 acmmax
+acn
 activates
 actived
 adjusts
@@ -24,6 +25,9 @@ alpnprotocols
 alterase
 alternating
 altitudes
+amb
+ambisonic
+ambisonics
 amr
 animatable
 annually
@@ -198,6 +202,7 @@ dnd
 dnses
 donot
 downlink
+downmix
 dpad
 drains
 dragbar
@@ -264,6 +269,8 @@ fstat
 fsync
 ftruncate
 fulfills
+fuma
+furse
 gamepad
 gba
 geofence
@@ -293,6 +300,7 @@ heapsnapshot
 heating
 heavier
 henkan
+hexadecagonal
 hfp
 hibernates
 hibernating
@@ -417,6 +425,7 @@ luma
 lushort
 lux
 mah
+malham
 map
 mcc
 md5
@@ -683,6 +692,7 @@ socid
 softer
 sonification
 sortings
+spatialization
 spawns
 spay
 spdy