1# multimedia子系统变更说明 2 3## cl.multimedia.1 image.Component.OH_PackingOptions_SetMimeType()接口Heif格式参数类型变更 4 5**访问级别** 6 7公开接口 8 9**变更原因** 10 11相机Heif编码时,使用图片标准定义image/heic参数编码失败,当前版本Image中的格式参数定义为image/heif,不符合图片标准定义,为提升规范性,将Heif格式图片mimeType变更为image/heic。 12 13**变更影响** 14 15该变更为不兼容变更。 16 17变更前:设置Heif格式图片mimeType传入参数为image/heif。 18 19变更后:设置Heif格式图片mimeType传入参数为image/heic。 20 21**起始API Level** 22 23API 12 24 25**变更发生的版本** 26 27从OpenHarmony 5.0.0.53版本开始。 28 29**变更的接口/组件** 30 31image_paker_native.h下的接口: 32 33Image_ErrorCode OH_PackingOptions_SetMimeType(OH_PackingOptions *options, Image_MimeType *format) 34 35**适配指导** 36 37调用OH_PackingOptions_SetMimeType(OH_PackingOptions *options, Image_MimeType *format)设置Heif格式图片mimeType时,需要将传入的format参数更新为image/heic。 38 39 40## cl.multimedia.2 image.Component.OH_PackingOptions_GetMimeType()接口Heif格式返回类型变更 41 42**访问级别** 43 44公开接口 45 46**变更原因** 47 48相机Heif编码时,使用图片标准定义image/heic参数编码失败,当前版本Image中的格式参数定义为image/heif,不符合图片标准定义,为提升规范性,将Heif格式图片mimeType变更为image/heic。 49 50**变更影响** 51 52该变更为不兼容变更。 53 54变更前:获取Heif格式图片mimeType为image/heif。 55 56变更后:获取Heif格式图片mimeType为image/heic。 57 58**起始API Level** 59 60API 12 61 62**变更发生的版本** 63 64从OpenHarmony 5.0.0.53版本开始。 65 66**变更的接口/组件** 67 68image_paker_native.h下的接口: 69 70Image_ErrorCode OH_PackingOptions_GetMimeType (OH_PackingOptions * options, Image_MimeType * format) 71 72**适配指导** 73 74调用OH_PackingOptions_GetMimeType(OH_PackingOptions *options, Image_MimeType *format)获取Heif格式图片mimeType时,返回的format为image/heic,开发者需检视应用的示例工程,根据实际情况修改。 75 76 77## cl.multimedia.3 image.Component.supportedFormats属性查询设备支持解码Heif格式返回类型变更 78 79**访问级别** 80 81公开接口 82 83**变更原因** 84 85相机Heif编码时,使用图片标准定义image/heic参数编码失败,当前版本Image中的格式参数定义为image/heif,不符合图片标准定义,为提升规范性,将Heif格式图片mimeType变更为image/heic。 86 87**变更影响** 88 89该变更为不兼容变更。 90 91变更前:查询设备支持的解码类型Heif格式返回值为image/heif。 92 93变更后:查询设备支持的解码类型Heif格式返回值为image/heic。 94 95**起始API Level** 96 97API 10 98 99**变更发生的版本** 100 101从OpenHarmony 5.0.0.53版本开始。 102 103**变更的接口/组件** 104 105/interface/sdk-js/api/@ohos.multimedia.image.d.ts下的属性: 106 107image.Component.readonly supportedFormats: Array\<string> 108 109**适配指导** 110 111调用该属性查询设备的解码类型时,开发者调用行为不变,如果设备支持Heif类型,返回值将由image/heif变更为image/heic。 112 113 114## cl.multimedia.4 image.Component.supportedFormats属性查询设备支持编码Heif格式返回类型变更 115 116**访问级别** 117 118公开接口 119 120**变更原因** 121 122相机Heif编码时,使用图片标准定义image/heic参数编码失败,当前版本Image中的格式参数定义为image/heif,不符合图片标准定义,为提升规范性,将Heif格式图片mimeType变更为image/heic。 123 124**变更影响** 125 126该变更为不兼容变更。 127 128变更前:查询设备支持的编码类型Heif格式返回值为image/heif。 129 130变更后:查询设备支持的编码类型Heif格式返回值为image/heic。 131 132**起始API Level** 133 134API 10 135 136**变更发生的版本** 137 138从OpenHarmony 5.0.0.53版本开始。 139 140**变更的接口/组件** 141 142/interface/sdk-js/api/@ohos.multimedia.image.d.ts下的属性: 143 144image.Component.readonly supportedFormats: Array\<string> 145 146**适配指导** 147 148调用该属性查询设备的编码类型时,开发者调用行为不变,如果设备支持Heif类型,返回值将由image/heif变更为image/heic。 149 150 151## cl.multimedia.5 image.Component.packing()接口Heif格式编码参数变更 152 153**访问级别** 154 155公开接口 156 157**变更原因** 158 159相机Heif编码时,使用图片标准定义image/heic参数编码失败,当前版本Image中的格式参数定义为image/heif,不符合图片标准定义,为提升规范性,将Heif格式图片mimeType变更为image/heic。 160 161**变更影响** 162 163该变更为兼容性变更。 164 165变更前:Heif格式图片编码参数的mimeType类型为image/heif。 166 167变更后:Heif格式图片编码参数的mimeType类型为image/heif或者image/heic。 168 169**起始API Level** 170 171API 12 172 173**变更发生的版本** 174 175从OpenHarmony 5.0.0.53版本开始。 176 177**变更的接口/组件** 178 179/interface/sdk-js/api/@ohos.multimedia.image.d.ts下的接口: 180 181image.Component.packing() 182 183**适配指导** 184 185在调用该接口进行Heif图片编码时,开发者调用参数可以使用变更前的image/heif类型,也可以使用image/heic类型,使用两种类型都可以将图片编码为heic格式。 186 187 188## cl.multimedia.6 image.Component.OH_PackingOptions结构体Heif格式编码参数变更 189 190**访问级别** 191 192公开接口 193 194**变更原因** 195 196相机Heif编码时,使用图片标准定义image/heic参数编码失败,当前版本Image中的格式参数定义为image/heif,不符合图片标准定义,为提升规范性,将Heif格式图片mimeType变更为image/heic。 197 198**变更影响** 199 200该变更为兼容性变更。 201 202变更前:Heif格式图片编码参数的mimeType类型为image/heif。 203 204变更后:Heif格式图片编码参数的mimeType类型为image/heif或者image/heic。 205 206**起始API Level** 207 208API 12 209 210**变更发生的版本** 211 212从OpenHarmony 5.0.0.53版本开始。 213 214**变更的接口/组件** 215 216image_packer_native.h下的属性: 217 218image.Component.OH_PackingOptions 219 220**适配指导** 221 222在调用该接口进行Heif图片编码时,开发者调用参数可以使用变更前的image/heif类型,也可以使用image/heic类型,使用两种类型都可以将图片编码为heic格式。