1# native_avmetadata.h 2<!--Kit: AVSession Kit--> 3<!--Subsystem: Multimedia--> 4<!--Owner: @ccfriend; @liao_qian--> 5<!--SE: @ccfriend--> 6<!--TSE: @chenmingxi1_huawei--> 7 8## Overview 9 10The file declares the definitions of playback control metadata. 11 12**File to include**: <multimedia/av_session/native_avmetadata.h> 13 14**Library**: libohavsession.so 15 16**System capability**: SystemCapability.Multimedia.AVSession.Core 17 18**Since**: 13 19 20**Related module**: [OHAVSession](capi-ohavsession.md) 21 22## Summary 23 24### Structs 25 26| Name| typedef Keyword| Description| 27| -- | -- | -- | 28| [OH_AVMetadataBuilderStruct](capi-ohavsession-oh-avmetadatabuilderstruct.md) | OH_AVMetadataBuilder | Defines a struct for the session metadata builder. The builder is used to construct session metadata.| 29| [OH_AVMetadataStruct](capi-ohavsession-oh-avmetadatastruct.md) | OH_AVMetadata | Defines a struct for the session metadata. It is an AVMetadata instance set for a media asset.| 30 31### Enums 32 33| Name| typedef Keyword| Description| 34| -- | -- | -- | 35| [AVMetadata_Result](#avmetadata_result) | AVMetadata_Result | Enumerates the error codes related to metadata operations.| 36| [AVMetadata_SkipIntervals](#avmetadata_skipintervals) | AVMetadata_SkipIntervals | Enumerates the fast-forward or rewind intervals supported by the media session.| 37| [AVMetadata_DisplayTag](#avmetadata_displaytag) | AVMetadata_DisplayTag | Enumerates the display tags of the media asset. The display tag is a special type identifier of the media audio source.| 38 39### Functions 40 41| Name| Description| 42| -- | -- | 43| [AVMetadata_Result OH_AVMetadataBuilder_Create(OH_AVMetadataBuilder** builder)](#oh_avmetadatabuilder_create) | Creates a metadata builder.| 44| [AVMetadata_Result OH_AVMetadataBuilder_Destroy(OH_AVMetadataBuilder* builder)](#oh_avmetadatabuilder_destroy) | Destroys a metadata builder.| 45| [AVMetadata_Result OH_AVMetadataBuilder_SetAssetId(OH_AVMetadataBuilder* builder, const char* assetId)](#oh_avmetadatabuilder_setassetid) | Sets the ID of the media asset.| 46| [AVMetadata_Result OH_AVMetadataBuilder_SetTitle(OH_AVMetadataBuilder* builder, const char* title)](#oh_avmetadatabuilder_settitle) | Sets a title for the media asset.| 47| [AVMetadata_Result OH_AVMetadataBuilder_SetArtist(OH_AVMetadataBuilder* builder, const char* artist)](#oh_avmetadatabuilder_setartist) | Sets an artist for the media asset.| 48| [AVMetadata_Result OH_AVMetadataBuilder_SetAuthor(OH_AVMetadataBuilder* builder, const char* author)](#oh_avmetadatabuilder_setauthor) | Sets an author for the media asset.| 49| [AVMetadata_Result OH_AVMetadataBuilder_SetAlbum(OH_AVMetadataBuilder* builder, const char* album)](#oh_avmetadatabuilder_setalbum) | Sets an album name for the media asset.| 50| [AVMetadata_Result OH_AVMetadataBuilder_SetWriter(OH_AVMetadataBuilder* builder, const char* writer)](#oh_avmetadatabuilder_setwriter) | Sets a writer for the media asset.| 51| [AVMetadata_Result OH_AVMetadataBuilder_SetComposer(OH_AVMetadataBuilder* builder, const char* composer)](#oh_avmetadatabuilder_setcomposer) | Sets a composer for the media asset.| 52| [AVMetadata_Result OH_AVMetadataBuilder_SetDuration(OH_AVMetadataBuilder* builder, int64_t duration)](#oh_avmetadatabuilder_setduration) | Sets the playback duration for the media asset.| 53| [AVMetadata_Result OH_AVMetadataBuilder_SetMediaImageUri(OH_AVMetadataBuilder* builder, const char* mediaImageUri)](#oh_avmetadatabuilder_setmediaimageuri) | Sets an image for the media asset.| 54| [AVMetadata_Result OH_AVMetadataBuilder_SetSubtitle(OH_AVMetadataBuilder* builder, const char* subtitle)](#oh_avmetadatabuilder_setsubtitle) | Sets a subtitle for the media asset.| 55| [AVMetadata_Result OH_AVMetadataBuilder_SetDescription(OH_AVMetadataBuilder* builder, const char* description)](#oh_avmetadatabuilder_setdescription) | Sets a description for the media asset.| 56| [AVMetadata_Result OH_AVMetadataBuilder_SetLyric(OH_AVMetadataBuilder* builder, const char* lyric)](#oh_avmetadatabuilder_setlyric) | Sets lyrics for the media asset.| 57| [AVMetadata_Result OH_AVMetadataBuilder_SetSkipIntervals(OH_AVMetadataBuilder* builder,AVMetadata_SkipIntervals intervals)](#oh_avmetadatabuilder_setskipintervals) | Sets the skip intervals for the media asset.| 58| [AVMetadata_Result OH_AVMetadataBuilder_SetDisplayTags(OH_AVMetadataBuilder* builder, int32_t tags)](#oh_avmetadatabuilder_setdisplaytags) | Sets display tags for the media asset.| 59| [AVMetadata_Result OH_AVMetadataBuilder_GenerateAVMetadata(OH_AVMetadataBuilder* builder,OH_AVMetadata** avMetadata)](#oh_avmetadatabuilder_generateavmetadata) | Generates an OH_AVMetadata object.| 60| [AVMetadata_Result OH_AVMetadata_Destroy(OH_AVMetadata* avMetadata)](#oh_avmetadata_destroy) | Releases an OH_AVMetadata object.| 61 62## Enums 63 64### AVMetadata_Result 65 66``` 67enum AVMetadata_Result 68``` 69 70**Description** 71 72Enumerates the error codes related to metadata operations. 73 74**Since**: 13 75 76| Enum Item| Description| 77| -- | -- | 78| AVMETADATA_SUCCESS = 0 | Operation successful.| 79| AVMETADATA_ERROR_INVALID_PARAM = 1 | Incorrect parameter.| 80| AVMETADATA_ERROR_NO_MEMORY = 2 | Insufficient memory.| 81 82### AVMetadata_SkipIntervals 83 84``` 85enum AVMetadata_SkipIntervals 86``` 87 88**Description** 89 90Enumerates the fast-forward or rewind intervals supported by the media session. 91 92**Since**: 13 93 94| Enum Item| Description| 95| -- | -- | 96| SECONDS_10 = 10 | The time is 10 seconds.| 97| SECONDS_15 = 15 | The time is 15 seconds.| 98| SECONDS_30 = 30 | The time is 30 seconds.| 99 100### AVMetadata_DisplayTag 101 102``` 103enum AVMetadata_DisplayTag 104``` 105 106**Description** 107 108Enumerates the display tags of the media asset. The display tag is a special type identifier of the media audio source. 109 110**Since**: 13 111 112| Enum Item| Description| 113| -- | -- | 114| AVSESSION_DISPLAYTAG_AUDIO_VIVID = 1 | AUDIO VIVID.| 115 116 117## Function Description 118 119### OH_AVMetadataBuilder_Create() 120 121``` 122AVMetadata_Result OH_AVMetadataBuilder_Create(OH_AVMetadataBuilder** builder) 123``` 124 125**Description** 126 127Creates a metadata builder. 128 129**Since**: 13 130 131 132**Parameters** 133 134| Name| Description| 135| -- | -- | 136| [OH_AVMetadataBuilder](capi-ohavsession-oh-avmetadatabuilderstruct.md)** builder | Double pointer to the builder created.| 137 138**Returns** 139 140| Type| Description| 141| -- | -- | 142| [AVMetadata_Result](capi-native-avmetadata-h.md#avmetadata_result) | **AVMETADATA_SUCCESS**: The function is executed successfully.<br> **AVMETADATA_ERROR_INVALID_PARAM**: **builder** is nullptr.<br> **AVMETADATA_ERROR_NO_MEMORY**: There is no sufficient memory.| 143 144### OH_AVMetadataBuilder_Destroy() 145 146``` 147AVMetadata_Result OH_AVMetadataBuilder_Destroy(OH_AVMetadataBuilder* builder) 148``` 149 150**Description** 151 152Destroys a metadata builder. 153 154**Since**: 13 155 156 157**Parameters** 158 159| Name| Description| 160| -- | -- | 161| [OH_AVMetadataBuilder](capi-ohavsession-oh-avmetadatabuilderstruct.md)* builder | Pointer to an OH_AVMetadataBuilder instance.| 162 163**Returns** 164 165| Type| Description| 166| -- | -- | 167| [AVMetadata_Result](capi-native-avmetadata-h.md#avmetadata_result) | **AVMETADATA_SUCCESS**: The function is executed successfully.<br> **AVMETADATA_ERROR_INVALID_PARAM**: **builder** is nullptr.| 168 169### OH_AVMetadataBuilder_SetAssetId() 170 171``` 172AVMetadata_Result OH_AVMetadataBuilder_SetAssetId(OH_AVMetadataBuilder* builder, const char* assetId) 173``` 174 175**Description** 176 177Sets the ID of the media asset. 178 179**Since**: 13 180 181 182**Parameters** 183 184| Name| Description| 185| -- | -- | 186| [OH_AVMetadataBuilder](capi-ohavsession-oh-avmetadatabuilderstruct.md)* builder | Pointer to an OH_AVMetadataBuilder instance.| 187| const char* assetId | Pointer to the asset ID.| 188 189**Returns** 190 191| Type| Description| 192| -- | -- | 193| [AVMetadata_Result](capi-native-avmetadata-h.md#avmetadata_result) | **AVMETADATA_SUCCESS**: The function is executed successfully.<br> **AVMETADATA_ERROR_INVALID_PARAM**:<br> 1. **builder** is nullptr.<br> 2. **assetId** is nullptr.| 194 195### OH_AVMetadataBuilder_SetTitle() 196 197``` 198AVMetadata_Result OH_AVMetadataBuilder_SetTitle(OH_AVMetadataBuilder* builder, const char* title) 199``` 200 201**Description** 202 203Sets a title for the media asset. 204 205**Since**: 13 206 207 208**Parameters** 209 210| Name| Description| 211| -- | -- | 212| [OH_AVMetadataBuilder](capi-ohavsession-oh-avmetadatabuilderstruct.md)* builder | Pointer to an OH_AVMetadataBuilder instance.| 213| const char* title | Pointer to the title.| 214 215**Returns** 216 217| Type| Description| 218| -- | -- | 219| [AVMetadata_Result](capi-native-avmetadata-h.md#avmetadata_result) | **AVMETADATA_SUCCESS**: The function is executed successfully.<br> **AVMETADATA_ERROR_INVALID_PARAM**:<br> 1. **builder** is nullptr.<br> 2. **title** is nullptr.| 220 221### OH_AVMetadataBuilder_SetArtist() 222 223``` 224AVMetadata_Result OH_AVMetadataBuilder_SetArtist(OH_AVMetadataBuilder* builder, const char* artist) 225``` 226 227**Description** 228 229Sets an artist for the media asset. 230 231**Since**: 13 232 233 234**Parameters** 235 236| Name| Description| 237| -- | -- | 238| [OH_AVMetadataBuilder](capi-ohavsession-oh-avmetadatabuilderstruct.md)* builder | Pointer to an OH_AVMetadataBuilder instance.| 239| const char* artist | Pointer to the artist.| 240 241**Returns** 242 243| Type| Description| 244| -- | -- | 245| [AVMetadata_Result](capi-native-avmetadata-h.md#avmetadata_result) | **AVMETADATA_SUCCESS**: The function is executed successfully.<br> **AVMETADATA_ERROR_INVALID_PARAM**:<br> 1. **builder** is nullptr.<br> 2. **artist** is nullptr.| 246 247### OH_AVMetadataBuilder_SetAuthor() 248 249``` 250AVMetadata_Result OH_AVMetadataBuilder_SetAuthor(OH_AVMetadataBuilder* builder, const char* author) 251``` 252 253**Description** 254 255Sets an author for the media asset. 256 257**Since**: 13 258 259 260**Parameters** 261 262| Name| Description| 263| -- | -- | 264| [OH_AVMetadataBuilder](capi-ohavsession-oh-avmetadatabuilderstruct.md)* builder | Pointer to an OH_AVMetadataBuilder instance.| 265| const char* author | Pointer to the author.| 266 267**Returns** 268 269| Type| Description| 270| -- | -- | 271| [AVMetadata_Result](capi-native-avmetadata-h.md#avmetadata_result) | **AVMETADATA_SUCCESS**: The function is executed successfully.<br> **AVMETADATA_ERROR_INVALID_PARAM**:<br> 1. **builder** is nullptr.<br> 2. **author** is nullptr.| 272 273### OH_AVMetadataBuilder_SetAlbum() 274 275``` 276AVMetadata_Result OH_AVMetadataBuilder_SetAlbum(OH_AVMetadataBuilder* builder, const char* album) 277``` 278 279**Description** 280 281Sets an album name for the media asset. 282 283**Since**: 13 284 285 286**Parameters** 287 288| Name| Description| 289| -- | -- | 290| [OH_AVMetadataBuilder](capi-ohavsession-oh-avmetadatabuilderstruct.md)* builder | Pointer to an OH_AVMetadataBuilder instance.| 291| const char* album | Pointer to the album name.| 292 293**Returns** 294 295| Type| Description| 296| -- | -- | 297| [AVMetadata_Result](capi-native-avmetadata-h.md#avmetadata_result) | **AVMETADATA_SUCCESS**: The function is executed successfully.<br> **AVMETADATA_ERROR_INVALID_PARAM**:<br> 1. **builder** is nullptr.<br> 2. **album** is nullptr.| 298 299### OH_AVMetadataBuilder_SetWriter() 300 301``` 302AVMetadata_Result OH_AVMetadataBuilder_SetWriter(OH_AVMetadataBuilder* builder, const char* writer) 303``` 304 305**Description** 306 307Sets a writer for the media asset. 308 309**Since**: 13 310 311 312**Parameters** 313 314| Name| Description| 315| -- | -- | 316| [OH_AVMetadataBuilder](capi-ohavsession-oh-avmetadatabuilderstruct.md)* builder | Pointer to an OH_AVMetadataBuilder instance.| 317| const char* writer | Pointer to the writer.| 318 319**Returns** 320 321| Type| Description| 322| -- | -- | 323| [AVMetadata_Result](capi-native-avmetadata-h.md#avmetadata_result) | **AVMETADATA_SUCCESS**: The function is executed successfully.<br> **AVMETADATA_ERROR_INVALID_PARAM**:<br> 1. **builder** is nullptr.<br> 2. **writer** is nullptr.| 324 325### OH_AVMetadataBuilder_SetComposer() 326 327``` 328AVMetadata_Result OH_AVMetadataBuilder_SetComposer(OH_AVMetadataBuilder* builder, const char* composer) 329``` 330 331**Description** 332 333Sets a composer for the media asset. 334 335**Since**: 13 336 337 338**Parameters** 339 340| Name| Description| 341| -- | -- | 342| [OH_AVMetadataBuilder](capi-ohavsession-oh-avmetadatabuilderstruct.md)* builder | Pointer to an OH_AVMetadataBuilder instance.| 343| const char* composer | Pointer to the composer.| 344 345**Returns** 346 347| Type| Description| 348| -- | -- | 349| [AVMetadata_Result](capi-native-avmetadata-h.md#avmetadata_result) | **AVMETADATA_SUCCESS**: The function is executed successfully.<br> **AVMETADATA_ERROR_INVALID_PARAM**:<br> 1. **builder** is nullptr.<br> 2. **composer** is nullptr.| 350 351### OH_AVMetadataBuilder_SetDuration() 352 353``` 354AVMetadata_Result OH_AVMetadataBuilder_SetDuration(OH_AVMetadataBuilder* builder, int64_t duration) 355``` 356 357**Description** 358 359Sets the playback duration for the media asset. 360 361**Since**: 13 362 363 364**Parameters** 365 366| Name| Description| 367| -- | -- | 368| [OH_AVMetadataBuilder](capi-ohavsession-oh-avmetadatabuilderstruct.md)* builder | Pointer to an OH_AVMetadataBuilder instance.| 369| int64_t duration | Playback duration, in ms.| 370 371**Returns** 372 373| Type| Description| 374| -- | -- | 375| [AVMetadata_Result](capi-native-avmetadata-h.md#avmetadata_result) | **AVMETADATA_SUCCESS**: The function is executed successfully.<br> **AVMETADATA_ERROR_INVALID_PARAM**: **builder** is nullptr.| 376 377### OH_AVMetadataBuilder_SetMediaImageUri() 378 379``` 380AVMetadata_Result OH_AVMetadataBuilder_SetMediaImageUri(OH_AVMetadataBuilder* builder, const char* mediaImageUri) 381``` 382 383**Description** 384 385Sets an image for the media asset. 386 387**Since**: 13 388 389 390**Parameters** 391 392| Name| Description| 393| -- | -- | 394| [OH_AVMetadataBuilder](capi-ohavsession-oh-avmetadatabuilderstruct.md)* builder | Pointer to an OH_AVMetadataBuilder instance.| 395| const char* mediaImageUri | Pointer to the URI of the image.| 396 397**Returns** 398 399| Type| Description| 400| -- | -- | 401| [AVMetadata_Result](capi-native-avmetadata-h.md#avmetadata_result) | **AVMETADATA_SUCCESS**: The function is executed successfully.<br> **AVMETADATA_ERROR_INVALID_PARAM**:<br> 1. **builder** is nullptr.<br> 2. **mediaImageUri** is nullptr.| 402 403### OH_AVMetadataBuilder_SetSubtitle() 404 405``` 406AVMetadata_Result OH_AVMetadataBuilder_SetSubtitle(OH_AVMetadataBuilder* builder, const char* subtitle) 407``` 408 409**Description** 410 411Sets a subtitle for the media asset. 412 413**Since**: 13 414 415 416**Parameters** 417 418| Name| Description| 419| -- | -- | 420| [OH_AVMetadataBuilder](capi-ohavsession-oh-avmetadatabuilderstruct.md)* builder | Pointer to an OH_AVMetadataBuilder instance.| 421| const char* subtitle | Pointer to the subtitle.| 422 423**Returns** 424 425| Type| Description| 426| -- | -- | 427| [AVMetadata_Result](capi-native-avmetadata-h.md#avmetadata_result) | **AVMETADATA_SUCCESS**: The function is executed successfully.<br> **AVMETADATA_ERROR_INVALID_PARAM**:<br> 1. **builder** is nullptr.<br> 2. **subtitle** is nullptr.| 428 429### OH_AVMetadataBuilder_SetDescription() 430 431``` 432AVMetadata_Result OH_AVMetadataBuilder_SetDescription(OH_AVMetadataBuilder* builder, const char* description) 433``` 434 435**Description** 436 437Sets a description for the media asset. 438 439**Since**: 13 440 441 442**Parameters** 443 444| Name| Description| 445| -- | -- | 446| [OH_AVMetadataBuilder](capi-ohavsession-oh-avmetadatabuilderstruct.md)* builder | Pointer to an OH_AVMetadataBuilder instance.| 447| const char* description | Pointer to the description.| 448 449**Returns** 450 451| Type| Description| 452| -- | -- | 453| [AVMetadata_Result](capi-native-avmetadata-h.md#avmetadata_result) | **AVMETADATA_SUCCESS**: The function is executed successfully.<br> **AVMETADATA_ERROR_INVALID_PARAM**:<br> 1. **builder** is nullptr.<br> 2. **description** is nullptr.| 454 455### OH_AVMetadataBuilder_SetLyric() 456 457``` 458AVMetadata_Result OH_AVMetadataBuilder_SetLyric(OH_AVMetadataBuilder* builder, const char* lyric) 459``` 460 461**Description** 462 463Sets lyrics for the media asset. 464 465**Since**: 13 466 467 468**Parameters** 469 470| Name| Description| 471| -- | -- | 472| [OH_AVMetadataBuilder](capi-ohavsession-oh-avmetadatabuilderstruct.md)* builder | Pointer to an OH_AVMetadataBuilder instance.| 473| const char* lyric | Pointer to the lyrics in the lrc format.| 474 475**Returns** 476 477| Type| Description| 478| -- | -- | 479| [AVMetadata_Result](capi-native-avmetadata-h.md#avmetadata_result) | **AVMETADATA_SUCCESS**: The function is executed successfully.<br> **AVMETADATA_ERROR_INVALID_PARAM**:<br> 1. **builder** is nullptr.<br> 2. **lyric** is nullptr.| 480 481### OH_AVMetadataBuilder_SetSkipIntervals() 482 483``` 484AVMetadata_Result OH_AVMetadataBuilder_SetSkipIntervals(OH_AVMetadataBuilder* builder,AVMetadata_SkipIntervals intervals) 485``` 486 487**Description** 488 489Sets the skip intervals for the media asset. 490 491**Since**: 13 492 493 494**Parameters** 495 496| Name| Description| 497| -- | -- | 498| [OH_AVMetadataBuilder](capi-ohavsession-oh-avmetadatabuilderstruct.md)* builder | Pointer to an OH_AVMetadataBuilder instance.| 499| [AVMetadata_SkipIntervals](capi-native-avmetadata-h.md#avmetadata_skipintervals) intervals | Skip intervals.| 500 501**Returns** 502 503| Type| Description| 504| -- | -- | 505| [AVMetadata_Result](capi-native-avmetadata-h.md#avmetadata_result) | **AVMETADATA_SUCCESS**: The function is executed successfully.<br> **AVMETADATA_ERROR_INVALID_PARAM**:<br> 1. **builder** is nullptr.<br> 2. **intervals** is invalid.| 506 507### OH_AVMetadataBuilder_SetDisplayTags() 508 509``` 510AVMetadata_Result OH_AVMetadataBuilder_SetDisplayTags(OH_AVMetadataBuilder* builder, int32_t tags) 511``` 512 513**Description** 514 515Sets display tags for the media asset. 516 517**Since**: 13 518 519 520**Parameters** 521 522| Name| Description| 523| -- | -- | 524| [OH_AVMetadataBuilder](capi-ohavsession-oh-avmetadatabuilderstruct.md)* builder | Pointer to an OH_AVMetadataBuilder instance.| 525| int32_t tags | Tags of the media asset displayed on the playback control page.| 526 527**Returns** 528 529| Type| Description| 530| -- | -- | 531| [AVMetadata_Result](capi-native-avmetadata-h.md#avmetadata_result) | **AVMETADATA_SUCCESS**: The function is executed successfully.<br> **AVMETADATA_ERROR_INVALID_PARAM**: **builder** is nullptr.| 532 533### OH_AVMetadataBuilder_GenerateAVMetadata() 534 535``` 536AVMetadata_Result OH_AVMetadataBuilder_GenerateAVMetadata(OH_AVMetadataBuilder* builder,OH_AVMetadata** avMetadata) 537``` 538 539**Description** 540 541Generates an OH_AVMetadata object. 542 543**Since**: 13 544 545 546**Parameters** 547 548| Name| Description| 549| -- | -- | 550| [OH_AVMetadataBuilder](capi-ohavsession-oh-avmetadatabuilderstruct.md)* builder | Pointer to an OH_AVMetadataBuilder instance.| 551| [OH_AVMetadata](capi-ohavsession-oh-avmetadatastruct.md)** avMetadata | Double pointer to the OH_AVMetadata object created.| 552 553**Returns** 554 555| Type| Description| 556| -- | -- | 557| [AVMetadata_Result](capi-native-avmetadata-h.md#avmetadata_result) | **AVMETADATA_SUCCESS**: The function is executed successfully.<br> **AVMETADATA_ERROR_NO_MEMORY**: The memory is insufficient.<br> **AVMETADATA_ERROR_INVALID_PARAM**:<br> 1. **builder** is nullptr.<br> 2. **avMetadata** is nullptr.| 558 559### OH_AVMetadata_Destroy() 560 561``` 562AVMetadata_Result OH_AVMetadata_Destroy(OH_AVMetadata* avMetadata) 563``` 564 565**Description** 566 567Releases an OH_AVMetadata object. 568 569**Since**: 13 570 571 572**Parameters** 573 574| Name| Description| 575| -- | -- | 576| [OH_AVMetadata](capi-ohavsession-oh-avmetadatastruct.md)* avMetadata | Pointer to an OH_AVMetadata object.| 577 578**Returns** 579 580| Type| Description| 581| -- | -- | 582| [AVMetadata_Result](capi-native-avmetadata-h.md#avmetadata_result) | **AVMETADATA_SUCCESS**: The function is executed successfully.<br> **AVMETADATA_ERROR_INVALID_PARAM**: **avMetadata** is nullptr.| 583