1# 媒体子系统Changelog 2 3## cl.media.1 应用创建SoundPool时调用media.createSoundPool接口行为变更 4 5**访问级别** 6 7公开接口 8 9**变更原因** 10 11原来的应用创建SoundPool实例，一个应用进程只能够创建一个SoundPool实例，为单实例模式，无法满足应用的使用场景。例如很多应用在使用SoundPool的能力的同时，还需要使用TimePicker组件(该组件中封装了SoundPool的能力)，单实例模式会使得SoundPool对象之间互相干扰，影响应用的使用体验。 12 13**变更影响** 14 15此变更不涉及应用适配。 16 17变更前：创建的SoundPool对象底层为单实例模式，一个应用进程只能够创建1个SoundPool实例。 18 19变更后：创建的SoundPool对象底层为多实例模式，一个应用进程最多能够创建128个SoundPool实例。 20 21**起始API Level** 22 23API 10 24 25**变更发生版本** 26 27从OpenHarmony SDK 5.1.0.56开始。 28 29**变更的接口/组件** 30 31- [media.createSoundPool](../../../application-dev/reference/apis-media-kit/arkts-apis-media-f.md#mediacreatesoundpool10) 32 33**适配指导** 34 35默认行为变更，无需适配。 36 37## cl.media.2 getTrackDescription行为变更 38 39**访问级别** 40 41公开接口 42 43**变更原因** 44 45在视频存在多个视频/音频/字幕轨的场景下，使用getTrackDescription查询轨道信息时，对于非当前播放的视频/音频/字幕轨道，接口返回了不准确的视频HDR类型、音频/字幕轨语种字段信息，以及不直观的默认mime信息。现对接口的行为修改，使其能够在这种情况下返回更加准确的轨道信息。 46 47**变更影响** 48 49此变更不涉及应用适配。 50 51变更前：调用接口查询轨道信息时，其中未播放的轨道，其hdr_type值固定为0，language值为undefined，mime值为audio/xxx或video/xxx。 52 53变更后：调用接口查询轨道信息时，其中未播放的轨道，其hdr_type值与资源一致，language值与资源一致，mime值为audio/unknown或video/unknown。 54| 接口声明 | 变更前 | 变更后 | 55| :--------------------------------------------------: | :------------------------------: | :---------------------------: | 56| getTrackDescription | 其中未播放的轨道<br/>hdr_type=0、language=undefined、mime=audio/xxx或video/xxx。 | 其中未播放的轨道<br/>hdr_type、language与资源信息一致、mime=audio/unknown或video/unknown。 | 57 58**起始 API Level** 59 609 61 62**变更发生的版本** 63 64从OpenHarmony SDK 5.1.0.56开始。 65 66**变更的接口/组件** 67 68[@ohos.multimedia.media](../../../application-dev/reference/apis-media-kit/js-apis-media.md)中的接口： 69- getTrackDescription(callback: AsyncCallback\<Array\<MediaDescription\>\>): void 70- getTrackDescription(): Promise\<Array\<MediaDescription\>\> 71 72**适配指导** 73 74默认行为变更，无需适配。 75 76## cl.media.3 setPlaybackStrategy行为变更 77 78**访问级别** 79 80公开接口 81 82**变更原因** 83 84由于使用setPlaybackStrategy接口时，只有同时将mutedMediaType设置为MediaType.MEDIA_TYPE_AUD，一起设置的其余参数才能生效。因此将接口行为修改为不设置mutedMediaType也可以设置其他属性。参考[PlaybackStrategy](../../../application-dev/reference/apis-media-kit/js-apis-media.md#playbackstrategy12)说明。 85 86**变更影响** 87 88此变更不涉及应用适配。 89 90变更前：使用该接口配置播放策略时，只有将mutedMediaType设置为MediaType.MEDIA_TYPE_AUD时，一起设置的其余参数才能生效。 91 92变更后：使用该接口配置播放策略时，任意参数组合设置都能生效。 93| 接口声明 | 变更前 | 变更后 | 94| :--------------------------------------------------: | :------------------------------: | :---------------------------: | 95| setPlaybackStrategy | 接口入参PlaybackStrategy的mutedMediaType<br/>设置为MediaType.MEDIA_TYPE_AUD时，参数设置才能生效。 | 任意参数组合设置都能生效。 | 96 97**起始 API Level** 98 9912 100 101**变更发生的版本** 102 103从OpenHarmony SDK 5.1.0.56开始。 104 105**变更的接口/组件** 106 107[@ohos.multimedia.media](../../../application-dev/reference/apis-media-kit/js-apis-media.md)中的接口： 108 109setPlaybackStrategy(strategy: PlaybackStrategy): Promise\<void\> 110 111**适配指导** 112 113默认行为变更，无需适配。 114 115## cl.media.4 setMediaSource行为变更 116 117**访问级别** 118 119公开接口 120 121**变更原因** 122 123在使用setMediaSource设置mutedMediaType属性时，参数设置不生效。需要变更为参数设置可以正常生效。参考[PlaybackStrategy](../../../application-dev/reference/apis-media-kit/js-apis-media.md#playbackstrategy12)说明。 124 125**变更影响** 126 127此变更不涉及应用适配。 128 129变更前：使用接口设置播放策略的mutedMediaType属性时，参数设置不生效。 130 131变更后：使用接口设置播放策略的mutedMediaType属性时，参数设置生效。 132| 接口声明 | 变更前 | 变更后 | 133| :--------------------------------------------------: | :------------------------------: | :---------------------------: | 134| setMediaSource | 设置mutedMediaType属性不生效。 | 设置mutedMediaType属性生效。 | 135 136**起始 API Level** 137 13812 139 140**变更发生的版本** 141 142从OpenHarmony SDK 5.1.0.56开始。 143 144**变更的接口/组件** 145 146[@ohos.multimedia.media](../../../application-dev/reference/apis-media-kit/js-apis-media.md)中的接口： 147 148setMediaSource(src:MediaSource, strategy?: PlaybackStrategy): Promise\<void\> 149 150**适配指导** 151 152默认行为变更，无需适配。 153