1# 视频解码 2 3调用者可以调用本模块的Native API接口，完成视频解码，即将媒体数据解码成YUV文件或送显。 4 5<!--RP3--><!--RP3End--> 6 7当前支持的解码能力如下： 8 9| 视频硬解类型 | 视频软解类型 | 10| --------------------- | ---------------- | 11| AVC(H.264)、HEVC(H.265) |AVC(H.264)、HEVC(H.265) | 12 13视频解码软/硬件解码存在差异，基于MimeType创建解码器时，软解当前仅支持 H264 (OH_AVCODEC_MIMETYPE_VIDEO_AVC)，硬解则支持 H264 (OH_AVCODEC_MIMETYPE_VIDEO_AVC) 和 H265 (OH_AVCODEC_MIMETYPE_VIDEO_HEVC)。 14 15每一种解码的能力范围，可以通过[获取支持的编解码能力](obtain-supported-codecs.md)获取。 16 17<!--RP1--><!--RP1End--> 18 19通过视频解码，应用可以实现以下重点能力，包括： 20 21| 支持的能力 | 使用简述 | 22| --------------------------------------- | ---------------------------------------------------------------------------------- | 23| 变分辨率 | 解码器支持输入码流分辨率发生变化，发生变化后会触发OH_VideoDecoder_RegisterCallback接口设置的回调函数OnStreamChanged()。具体可参考下文中：Surface模式步骤-4或Buffer模式步骤-3 | 24| 动态切换surface | 通过调用OH_VideoDecoder_SetSurface接口配置，仅Surface模式支持。具体可参考下文中：Surface模式步骤-7 | 25| 低时延解码 | 通过调用OH_VideoDecoder_Configure接口配置，具体可参考下文中：Surface模式的步骤-6或Buffer模式步骤-5 | 26 27 28## 限制约束 291. Buffer模式不支持10bit的图像数据。 302. Flush，Reset，Stop之后，重新Start时，需要重新传PPS/SPS。具体示例请参考[Surface模式](#surface模式)步骤14调用OH_VideoDecoder_Flush()。 313. 由于硬件解码器资源有限，每个解码器在使用完毕后都必须调用OH_VideoDecoder_Destroy接口来销毁实例并释放资源。 324. 视频解码输入码流仅支持AnnexB格式，且支持的AnnexB格式支持多slice，要求同一帧的多个slice一次送入解码器。 335. 在调用Flush，Reset，Stop的过程中，调用者不应对之前回调函数获取到的OH_AVBuffer继续进行操作。 346. DRM解密能力在[Surface模式](#surface模式)下既支持非安全视频通路，也支持安全视频通路，在[Buffer模式](#buffer模式)下仅支持非安全视频通路。 357. Buffer模式和Surface模式使用方式一致的接口，所以只提供了Surface模式的示例。 368. 在Buffer模式下，调用者通过输出回调函数OH_AVCodecOnNewOutputBuffer获取到OH_AVBuffer的指针对象后，必须通过调用OH_VideoDecoder_FreeOutputBuffer接口 37 来通知系统该对象已被使用完毕。这样系统才能够将后续解码的数据写入到相应的位置。如果调用者在调用OH_AVBuffer_GetNativeBuffer接口时获取到OH_NativeBuffer指针对象，并且该对象的生命周期超过了当前的OH_AVBuffer指针对象，那么需要进行一次数据的拷贝操作。在这种情况下，调用者需要自行管理新生成的OH_NativeBuffer对象的生命周期，确保其正确使用和释放。 38 39## surface输出与buffer输出 40 411. 两者数据的输出方式不同。 422. 两者的适用场景不同： 43- surface输出是指用OHNativeWindow来传递输出数据，可以与其他模块对接，例如XComponent。 44- buffer输出是指经过解码的数据会以共享内存的方式输出。 45 463. 在接口调用的过程中，两种方式的接口调用方式基本一致，但存在以下差异点： 47- 在Surface模式下，可选择调用OH_VideoDecoder_FreeOutputBuffer接口丢弃输出帧（不送显）；在Buffer模式下，应用必须调用OH_VideoDecoder_FreeOutputBuffer接口释放数据。 48- Surface模式下，应用在解码器就绪前，必须调用OH_VideoDecoder_SetSurface接口设置OHNativeWindow，启动后，调用OH_VideoDecoder_RenderOutputBuffer接口将解码数据送显。 49- 输出回调传出的buffer，在Buffer模式下，可以获取共享内存的地址和数据信息；在Surface模式下，只能获取buffer的数据信息。 50 51两种模式的开发步骤详细说明请参考：[Surface模式](#surface模式)和[Buffer模式](#buffer模式)。 52 53## 状态机调用关系 54如下为状态机调用关系图： 55 56 57 58 591. 有两种方式可以使解码器进入Initialized状态： 60 - 初始创建解码器实例时，解码器处于Initialized状态。 61 - 任何状态下，调用OH_VideoDecoder_Reset接口，解码器将会移回Initialized状态。 62 632. Initialized状态下，调用OH_VideoDecoder_Configure接口配置解码器，配置成功后解码器进入Configured状态。 643. Configured状态下，调用OH_VideoDecoder_Prepare接口进入Prepared状态。 654. Prepared状态下，调用OH_VideoDecoder_Start接口使解码器进入Executing状态： 66 - 处于Executing状态时，调用OH_VideoDecoder_Stop接口可以使解码器返回到Prepared状态。 67 685. 在极少数情况下，解码器可能会遇到错误并进入Error状态。解码器的错误传递，可以通过队列操作返回无效值或者抛出异常： 69 - Error状态下，可以调用解码器OH_VideoDecoder_Reset接口将解码器移到Initialized状态；或者调用OH_VideoDecoder_Destroy接口移动到最后的Released状态。 70 716. Executing状态具有三个子状态：Flushed、Running和End-of-Stream： 72 - 在调用了OH_VideoDecoder_Start接口之后，解码器立即进入Running子状态。 73 - 对于处于Executing状态的解码器，可以调用OH_VideoDecoder_Flush接口返回到Flushed子状态。 74 - 当待处理数据全部传递给解码器后，在input buffers队列中为最后一个入队的input buffer中添加[AVCODEC_BUFFER_FLAGS_EOS](../../reference/apis-avcodec-kit/_core.md#oh_avcodecbufferflags-1)标记，遇到这个标记时，解码器会转换为End-of-Stream子状态。在此状态下，解码器不再接受新的输入，但是仍然会继续生成输出，直到输出到达尾帧。 75 767. 使用完解码器后，必须调用OH_VideoDecoder_Destroy接口销毁解码器实例。使解码器进入Released状态。 77 78## 开发指导 79 80详细的API说明请参考[API文档](../../reference/apis-avcodec-kit/_video_decoder.md)。 81如下为视频解码调用关系图： 82 83- 虚线表示可选。 84 85- 实线表示必选。 86 87 88 89### 在 CMake 脚本中链接动态库 90 91``` cmake 92target_link_libraries(sample PUBLIC libnative_media_codecbase.so) 93target_link_libraries(sample PUBLIC libnative_media_core.so) 94target_link_libraries(sample PUBLIC libnative_media_vdec.so) 95``` 96> **说明：** 97> 98> 上述'sample'字样仅为示例，此处由调用者根据实际工程目录自定义。 99> 100 101### Surface模式 102 103参考以下示例代码，调用者可以完成Surface模式下视频解码的全流程。此处以H.264码流文件输入，解码送显输出为例。 104本模块目前仅支持异步模式的数据轮转。 105 1061. 添加头文件。 107 108 ```c++ 109 #include <multimedia/player_framework/native_avcodec_videodecoder.h> 110 #include <multimedia/player_framework/native_avcapability.h> 111 #include <multimedia/player_framework/native_avcodec_base.h> 112 #include <multimedia/player_framework/native_avformat.h> 113 #include <multimedia/player_framework/native_avbuffer.h> 114 #include <fstream> 115 ``` 1162. 全局变量。 117 118 ```c++ 119 // 配置视频帧宽度（必须） 120 int32_t width = 320; 121 // 配置视频帧高度（必须） 122 int32_t height = 240; 123 // 配置视频像素格式 124 constexpr OH_AVPixelFormat DEFAULT_PIXELFORMAT = AV_PIXEL_FORMAT_NV12; 125 int32_t widthStride = 0; 126 int32_t heightStride = 0; 127 ``` 128 1293. 创建解码器实例对象。 130 131 调用者可以通过名称或媒体类型创建解码器。示例中的变量说明如下： 132 133 - videoDec：视频解码器实例的指针。 134 - capability：解码器能力查询实例的指针。 135 - OH_AVCODEC_MIMETYPE_VIDEO_AVC：AVC格式视频编解码器。 136 137 ```c++ 138 // 通过codecname创建解码器，应用有特殊需求，比如选择支持某种分辨率规格的解码器，可先查询capability，再根据codec name创建解码器。 139 OH_AVCapability *capability = OH_AVCodec_GetCapability(OH_AVCODEC_MIMETYPE_VIDEO_AVC, false); 140 // 创建硬件解码器实例 141 OH_AVCapability *capability= OH_AVCodec_GetCapabilityByCategory(OH_AVCODEC_MIMETYPE_VIDEO_AVC, false, HARDWARE); 142 const char *name = OH_AVCapability_GetName(capability); 143 OH_AVCodec *videoDec = OH_VideoDecoder_CreateByName(name); 144 ``` 145 146 ```c++ 147 // 通过MIME TYPE创建解码器，只能创建系统推荐的特定编解码器 148 // 涉及创建多路编解码器时，优先创建硬件解码器实例，硬件资源不够时再创建软件解码器实例 149 // 软/硬解: 创建H264解码器 150 OH_AVCodec *videoDec = OH_VideoDecoder_CreateByMime(OH_AVCODEC_MIMETYPE_VIDEO_AVC); 151 // 软/硬解: 创建H265解码器 152 OH_AVCodec *videoDec = OH_VideoDecoder_CreateByMime(OH_AVCODEC_MIMETYPE_VIDEO_HEVC); 153 ``` 154 1554. 调用OH_VideoDecoder_RegisterCallback()设置回调函数。 156 157 注册回调函数指针集合OH_AVCodecCallback，包括： 158 159 - OH_AVCodecOnError 解码器运行错误，返回的错误码详情请参见：[OH_AVCodecOnError](../../reference/apis-avcodec-kit/_codec_base.md#oh_avcodeconerror)； 160 - OH_AVCodecOnStreamChanged 码流信息变化，如码流宽、高变化； 161 - OH_AVCodecOnNeedInputBuffer 运行过程中需要新的输入数据，即解码器已准备好，可以输入数据； 162 - OH_AVCodecOnNewOutputBuffer 运行过程中产生了新的输出数据，即解码完成(注：Surface模式buffer参数为空)。 163 164 调用者可以通过处理该回调报告的信息，确保解码器正常运转。 165 166 <!--RP2--><!--RP2End--> 167 168 ```c++ 169 // 解码异常回调OH_AVCodecOnError实现 170 static void OnError(OH_AVCodec *codec, int32_t errorCode, void *userData) 171 { 172 // 回调的错误码由调用者判断处理 173 (void)codec; 174 (void)errorCode; 175 (void)userData; 176 } 177 178 // 解码数据流变化回调OH_AVCodecOnStreamChanged实现 179 static void OnStreamChanged(OH_AVCodec *codec, OH_AVFormat *format, void *userData) 180 { 181 // 可通过format获取到变化后的视频宽、高、跨距等 182 (void)codec; 183 (void)userData; 184 OH_AVFormat_GetIntValue(format, OH_MD_KEY_VIDEO_PIC_WIDTH, &width); 185 OH_AVFormat_GetIntValue(format, OH_MD_KEY_VIDEO_PIC_HEIGHT, &height); 186 OH_AVFormat_GetIntValue(format, OH_MD_KEY_VIDEO_STRIDE, &widthStride); 187 OH_AVFormat_GetIntValue(format, OH_MD_KEY_VIDEO_SLICE_HEIGHT, &heightStride); 188 } 189 190 // 解码输入回调OH_AVCodecOnNeedInputBuffer实现 191 static void OnNeedInputBuffer(OH_AVCodec *codec, uint32_t index, OH_AVBuffer *buffer, void *userData) 192 { 193 // 输入帧buffer对应的index，送入InIndexQueue队列 194 // 输入帧的数据buffer送入InBufferQueue队列 195 // 数据处理 196 // 写入解码码流 197 } 198 199 // 解码输出回调OH_AVCodecOnNewOutputBuffer实现 200 static void OnNewOutputBuffer(OH_AVCodec *codec, uint32_t index, OH_AVBuffer *buffer, void *userData) 201 { 202 // 完成帧buffer对应的index，送入outIndexQueue队列 203 // 完成帧的数据buffer送入outBufferQueue队列 204 // 数据处理 205 // 显示并释放解码帧 206 } 207 // 配置异步回调，调用 OH_VideoDecoder_RegisterCallback 接口 208 OH_AVCodecCallback cb = {&OnError, &OnStreamChanged, &OnNeedInputBuffer, &OnNewOutputBuffer}; 209 // 配置异步回调 210 int32_t ret = OH_VideoDecoder_RegisterCallback(videoDec, cb, NULL); // NULL:用户特定数据userData为空 211 if (ret != AV_ERR_OK) { 212 // 异常处理 213 } 214 ``` 215 > **说明：** 216 > 217 > 1. 在回调函数中，对数据队列进行操作时，需要注意多线程同步的问题。 218 > 2. 播放视频时，若视频码流的SPS中包含颜色信息，解码器会把这些信息（RangeFlag、ColorPrimary、MatrixCoefficient、TransferCharacteristic）通过 219 > OH_AVCodecOnStreamChanged接口中的OH_AVFormat返回。 220 > 221 2225. （可选）OH_VideoDecoder_SetDecryptionConfig设置解密配置。在获取到DRM信息(参考[音视频解封装](audio-video-demuxer.md)开发步骤第3步)，完成DRM许可证申请后，通过此接口进行解密配置。此接口需在Prepare前调用。在Surface模式下，DRM解密能力既支持安全视频通路，也支持非安全视频通路。DRM相关接口详见[DRM API文档](../../reference/apis-drm-kit/_drm.md)。 223 224 添加头文件。 225 226 ```c++ 227 #include <multimedia/drm_framework/native_mediakeysystem.h> 228 #include <multimedia/drm_framework/native_mediakeysession.h> 229 #include <multimedia/drm_framework/native_drm_err.h> 230 #include <multimedia/drm_framework/native_drm_common.h> 231 ``` 232 在 CMake 脚本中链接动态库。 233 234 ``` cmake 235 target_link_libraries(sample PUBLIC libnative_drm.so) 236 ``` 237 238 <!--RP4-->使用示例：<!--RP4End--> 239 240 ```c++ 241 // 根据DRM信息创建指定的DRM系统, 以创建"com.clearplay.drm"为例 242 MediaKeySystem *system = nullptr; 243 int32_t ret = OH_MediaKeySystem_Create("com.clearplay.drm", &system); 244 if (system == nullptr) { 245 printf("create media key system failed"); 246 return; 247 } 248 249 // 创建解密会话，如果使用安全视频通路，应创建CONTENT_PROTECTION_LEVEL_HW_CRYPTO及其以上内容保护级别的MediaKeySession； 250 // 如果使用非安全视频通路，应创建CONTENT_PROTECTION_LEVEL_SW_CRYPTO及以上内容保护级别的MediaKeySession 251 MediaKeySession *session = nullptr; 252 DRM_ContentProtectionLevel contentProtectionLevel = CONTENT_PROTECTION_LEVEL_SW_CRYPTO; 253 ret = OH_MediaKeySystem_CreateMediaKeySession(system, &contentProtectionLevel, &session); 254 if (ret != DRM_OK) { 255 // 如创建失败，请查看DRM接口文档及日志信息 256 printf("create media key session failed."); 257 return; 258 } 259 if (session == nullptr) { 260 printf("media key session is nullptr."); 261 return; 262 } 263 264 // 获取许可证请求、设置许可证响应等 265 266 // 设置解密配置, 即将解密会话、安全视频通路标志设置到解码器中 267 // 如果DRM解决方案支持安全视频通路，在使用安全视频通路时，需将secureVideoPath设置为true，并在此之前须创建安全解码器 268 // 即在步骤3使用OH_VideoDecoder_CreateByName函数、参数为解码器名称后拼接.secure（如“[CodecName].secure”）创建安全解码器 269 bool secureVideoPath = false; 270 ret = OH_VideoDecoder_SetDecryptionConfig(videoDec, session, secureVideoPath); 271 ``` 272 2736. 调用OH_VideoDecoder_Configure()配置解码器。 274 275 详细可配置选项的说明请参考[视频专有键值对](../../reference/apis-avcodec-kit/_codec_base.md#媒体数据键值对)。 276 277 参数校验规则请参考[OH_VideoDecoder_Configure() 参考文档](../../reference/apis-avcodec-kit/_video_decoder.md#oh_videodecoder_configure)。 278 279 参数取值范围可以通过能力查询接口获取，具体示例请参考[获取支持的编解码能力](obtain-supported-codecs.md)。 280 281 目前支持的所有格式都必须配置以下选项：视频帧宽度、视频帧高度、视频像素格式。示例中的变量如下： 282 283 - DEFAULT_WIDTH：320像素宽度； 284 - DEFAULT_HEIGHT：240像素高度； 285 - DEFAULT_PIXELFORMAT： 像素格式，因为示例需要保存的YUV文件像素格式是NV12，所以设置为 AV_PIXEL_FORMAT_NV12。 286 287 ```c++ 288 289 OH_AVFormat *format = OH_AVFormat_Create(); 290 // 写入format 291 OH_AVFormat_SetIntValue(format, OH_MD_KEY_WIDTH, width); // 必须配置 292 OH_AVFormat_SetIntValue(format, OH_MD_KEY_HEIGHT, height); // 必须配置 293 OH_AVFormat_SetIntValue(format, OH_MD_KEY_PIXEL_FORMAT, DEFAULT_PIXELFORMAT); 294 // 可选，配置低时延解码 295 OH_AVFormat_SetIntValue(format, OH_MD_KEY_VIDEO_ENABLE_LOW_LATENCY, 1); 296 // 配置解码器 297 int32_t ret = OH_VideoDecoder_Configure(videoDec, format); 298 if (ret != AV_ERR_OK) { 299 // 异常处理 300 } 301 OH_AVFormat_Destroy(format); 302 ``` 303 3047. 设置surface。 305 306 本例中的nativeWindow，有两种方式获取： 307 1. 如果解码后直接显示，则从XComponent组件获取，获取方式请参考 [XComponent](../../reference/apis-arkui/arkui-ts/ts-basic-components-xcomponent.md)； 308 2. 如果解码后接OpenGL后处理，则从NativeImage获取，获取方式请参考 [NativeImage](../../graphics/native-image-guidelines.md)。 309 310 Surface模式，调用者可以在解码过程中执行该步骤，即动态切换surface。 311 312 ```c++ 313 // 配置送显窗口参数 314 int32_t ret = OH_VideoDecoder_SetSurface(videoDec, window); // 从XComponent获取window 315 if (ret != AV_ERR_OK) { 316 // 异常处理 317 } 318 ``` 319 3208. （可选）OH_VideoDecoder_SetParameter()动态配置解码器surface参数。 321 详细可配置选项的说明请参考[视频专有键值对](../../reference/apis-avcodec-kit/_codec_base.md#媒体数据键值对)。 322 323 ```c++ 324 OH_AVFormat *format = OH_AVFormat_Create(); 325 // 配置显示旋转角度 326 OH_AVFormat_SetIntValue(format, OH_MD_KEY_ROTATION, 90); 327 // 配置视频与显示屏匹配模式（缩放与显示窗口适配，裁剪与显示窗口适配） 328 OH_AVFormat_SetIntValue(format, OH_MD_KEY_SCALING_MODE, SCALING_MODE_SCALE_CROP); 329 int32_t ret = OH_VideoDecoder_SetParameter(videoDec, format); 330 OH_AVFormat_Destroy(format); 331 ``` 332 3339. 调用OH_VideoDecoder_Prepare()解码器就绪。 334 335 该接口将在解码器运行前进行一些数据的准备工作。 336 337 ```c++ 338 ret = OH_VideoDecoder_Prepare(videoDec); 339 if (ret != AV_ERR_OK) { 340 // 异常处理 341 } 342 ``` 343 34410. 调用OH_VideoDecoder_Start()启动解码器。 345 346 ```c++ 347 std::string_view inputFilePath = "/*yourpath*.h264"; 348 std::unique_ptr<std::ifstream> inputFile = std::make_unique<std::ifstream>(); 349 inputFile->open(inputFilePath.data(), std::ios::in | std::ios::binary); 350 // 启动解码器，开始解码 351 int32_t ret = OH_VideoDecoder_Start(videoDec); 352 if (ret != AV_ERR_OK) { 353 // 异常处理 354 } 355 ``` 356 35711. （可选）调用OH_AVCencInfo_SetAVBuffer()，设置cencInfo。 358 359 若当前播放的节目是DRM加密节目，应用自行实现媒体解封装功能而非使用系统[解封装](audio-video-demuxer.md)功能时，需调用OH_AVCencInfo_SetAVBuffer()将cencInfo设置到AVBuffer，这样AVBuffer携带待解密的数据以及cencInfo，以实现AVBuffer中媒体数据的解密。当应用使用系统[解封装](audio-video-demuxer.md)功能时，则无需调用此接口。 360 361 添加头文件。 362 363 ```c++ 364 #include <multimedia/player_framework/native_cencinfo.h> 365 ``` 366 在 CMake 脚本中链接动态库。 367 368 ``` cmake 369 target_link_libraries(sample PUBLIC libnative_media_avcencinfo.so) 370 ``` 371 372 使用示例： 373 - buffer：回调函数OnNeedInputBuffer传入的参数，可以通过OH_AVBuffer_GetAddr接口获取图像虚拟地址。 374 ```c++ 375 uint32_t keyIdLen = DRM_KEY_ID_SIZE; 376 uint8_t keyId[] = { 377 0xd4, 0xb2, 0x01, 0xe4, 0x61, 0xc8, 0x98, 0x96, 378 0xcf, 0x05, 0x22, 0x39, 0x8d, 0x09, 0xe6, 0x28}; 379 uint32_t ivLen = DRM_KEY_IV_SIZE; 380 uint8_t iv[] = { 381 0xbf, 0x77, 0xed, 0x51, 0x81, 0xde, 0x36, 0x3e, 382 0x52, 0xf7, 0x20, 0x4f, 0x72, 0x14, 0xa3, 0x95}; 383 uint32_t encryptedBlockCount = 0; 384 uint32_t skippedBlockCount = 0; 385 uint32_t firstEncryptedOffset = 0; 386 uint32_t subsampleCount = 1; 387 DrmSubsample subsamples[1] = { {0x10, 0x16} }; 388 // 创建CencInfo实例 389 OH_AVCencInfo *cencInfo = OH_AVCencInfo_Create(); 390 if (cencInfo == nullptr) { 391 // 异常处理 392 } 393 // 设置解密算法 394 OH_AVErrCode errNo = OH_AVCencInfo_SetAlgorithm(cencInfo, DRM_ALG_CENC_AES_CTR); 395 if (errNo != AV_ERR_OK) { 396 // 异常处理 397 } 398 // 设置KeyId和Iv 399 errNo = OH_AVCencInfo_SetKeyIdAndIv(cencInfo, keyId, keyIdLen, iv, ivLen); 400 if (errNo != AV_ERR_OK) { 401 // 异常处理 402 } 403 // 设置Sample信息 404 errNo = OH_AVCencInfo_SetSubsampleInfo(cencInfo, encryptedBlockCount, skippedBlockCount, firstEncryptedOffset, 405 subsampleCount, subsamples); 406 if (errNo != AV_ERR_OK) { 407 // 异常处理 408 } 409 // 设置模式：KeyId、Iv和SubSamples已被设置 410 errNo = OH_AVCencInfo_SetMode(cencInfo, DRM_CENC_INFO_KEY_IV_SUBSAMPLES_SET); 411 if (errNo != AV_ERR_OK) { 412 // 异常处理 413 } 414 // 将CencInfo设置到AVBuffer中 415 errNo = OH_AVCencInfo_SetAVBuffer(cencInfo, buffer); 416 if (errNo != AV_ERR_OK) { 417 // 异常处理 418 } 419 // 销毁CencInfo实例 420 errNo = OH_AVCencInfo_Destroy(cencInfo); 421 if (errNo != AV_ERR_OK) { 422 // 异常处理 423 } 424 ``` 425 42612. 调用OH_VideoDecoder_PushInputBuffer()写入解码码流。 427 428 送入输入队列进行解码，以下示例中： 429 430 - buffer：回调函数OnNeedInputBuffer传入的参数，Surface模式调用者无法通过OH_AVBuffer_GetAddr接口获取图像虚拟地址。 431 - index：回调函数OnNeedInputBuffer传入的参数，与buffer唯一对应的标识。 432 - size, offset, pts：输入尺寸、偏移量、时间戳等字段信息，获取方式可以参考[音视频解封装](./audio-video-demuxer.md)。 433 - flags：缓冲区标记的类别，请参考[OH_AVCodecBufferFlags](../../reference/apis-avcodec-kit/_core.md#oh_avcodecbufferflags)。 434 435 ```c++ 436 // 配置帧数据的输入尺寸、偏移量、时间戳等字段信息 437 OH_AVCodecBufferAttr info; 438 info.size = size; 439 info.offset = offset; 440 info.pts = pts; 441 info.flags = flags; 442 // info信息写入buffer 443 int32_t ret = OH_AVBuffer_SetBufferAttr(buffer, &info); 444 if (ret != AV_ERR_OK) { 445 // 异常处理 446 } 447 // 送入解码输入队列进行解码，index为对应队列下标 448 ret = OH_VideoDecoder_PushInputBuffer(videoDec, index); 449 if (ret != AV_ERR_OK) { 450 // 异常处理 451 } 452 ``` 453 45413. 调用OH_VideoDecoder_RenderOutputBuffer()/OH_VideoDecoder_RenderOutputBufferAtTime()显示并释放解码帧， 455 或调用OH_VideoDecoder_FreeOutputBuffer()释放解码帧。 456 以下示例中： 457 458 - index：回调函数OnNewOutputBuffer传入的参数，与buffer唯一对应的标识。 459 - buffer：回调函数OnNewOutputBuffer传入的参数，Surface模式调用者无法通过OH_AVBuffer_GetAddr接口获取图像虚拟地址。 460 461 添加头文件。 462 463 ```c++ 464 #include <chrono> 465 ``` 466 467 ```c++ 468 // 获取解码后信息 469 OH_AVCodecBufferAttr info; 470 int32_t ret = OH_AVBuffer_GetBufferAttr(buffer, &info); 471 if (ret != AV_ERR_OK) { 472 // 异常处理 473 } 474 // 值由调用者决定 475 bool isRender; 476 bool isNeedRenderAtTime; 477 if (isRender) { 478 // 显示并释放已完成处理的信息，index为对应buffer队列下标 479 if (isNeedRenderAtTime){ 480 // 获取系统绝对时间，renderTimestamp由调用者结合业务指定显示时间 481 int64_t renderTimestamp = 482 chrono::duration_cast<chrono::nanoseconds>(chrono::high_resolution_clock::now().time_since_epoch()).count(); 483 ret = OH_VideoDecoder_RenderOutputBufferAtTime(videoDec, index, renderTimestamp); 484 } else { 485 ret = OH_VideoDecoder_RenderOutputBuffer(videoDec, index); 486 } 487 488 } else { 489 // 释放已完成处理的信息 490 ret = OH_VideoDecoder_FreeOutputBuffer(videoDec, index); 491 } 492 if (ret != AV_ERR_OK) { 493 // 异常处理 494 } 495 ``` 496 > **注意：** 497 > 如果要获取buffer的属性，如pixel_format、stride等可通过调用[OH_NativeWindow_NativeWindowHandleOpt](../../reference/apis-arkgraphics2d/_native_window.md#oh_nativewindow_nativewindowhandleopt)接口获取。 498 > 499 50014. （可选）调用OH_VideoDecoder_Flush()刷新解码器。 501 502 调用OH_VideoDecoder_Flush接口后，解码器仍处于运行态，但会清除解码器中缓存的输入和输出数据及参数集如H264格式的PPS/SPS。 503 此时需要调用OH_VideoDecoder_Start接口重新开始解码。 504 505 ```c++ 506 // 刷新解码器videoDec 507 int32_t ret = OH_VideoDecoder_Flush(videoDec); 508 if (ret != AV_ERR_OK) { 509 // 异常处理 510 } 511 // 重新开始解码 512 ret = OH_VideoDecoder_Start(videoDec); 513 if (ret != AV_ERR_OK) { 514 // 异常处理 515 } 516 // 重传PPS/SPS 517 // 配置帧数据PPS/SPS信息 518 OH_AVCodecBufferAttr info; 519 info.flags = AVCODEC_BUFFER_FLAG_CODEC_DATA; 520 // info信息写入buffer 521 int32_t ret = OH_AVBuffer_SetBufferAttr(buffer, &info); 522 if (ret != AV_ERR_OK) { 523 // 异常处理 524 } 525 // 将帧数据推送到解码器中，index为对应队列下标 526 ret = OH_VideoDecoder_PushInputBuffer(videoDec, index); 527 if (ret != AV_ERR_OK) { 528 // 异常处理 529 } 530 ``` 531 > **注意：** 532 > Flush之后，重新调用OH_VideoDecoder_Start接口时，需要重新传PPS/SPS。 533 > 534 535 53615. （可选）调用OH_VideoDecoder_Reset()重置解码器。 537 538 调用OH_VideoDecoder_Reset接口后，解码器回到初始化的状态，需要调用OH_VideoDecoder_Configure接口、OH_VideoDecoder_SetSurface接口和OH_VideoDecoder_Prepare接口重新配置。 539 540 ```c++ 541 // 重置解码器videoDec 542 int32_t ret = OH_VideoDecoder_Reset(videoDec); 543 if (ret != AV_ERR_OK) { 544 // 异常处理 545 } 546 // 重新配置解码器参数 547 ret = OH_VideoDecoder_Configure(videoDec, format); 548 if (ret != AV_ERR_OK) { 549 // 异常处理 550 } 551 // Surface模式重新配置surface，而Buffer模式不需要配置surface 552 ret = OH_VideoDecoder_SetSurface(videoDec, window); 553 if (ret != AV_ERR_OK) { 554 // 异常处理 555 } 556 // 解码器重新就绪 557 ret = OH_VideoDecoder_Prepare(videoDec); 558 if (ret != AV_ERR_OK) { 559 // 异常处理 560 } 561 ``` 562 56316. （可选）调用OH_VideoDecoder_Stop()停止解码器。 564 565 调用OH_VideoDecoder_Stop()后，解码器保留了解码实例，释放输入输出buffer。调用者可以直接调用OH_VideoDecoder_Start接口继续解码，输入的第一个buffer需要携带参数集，从IDR帧开始送入。 566 567 ```c++ 568 // 终止解码器videoDec 569 int32_t ret = OH_VideoDecoder_Stop(videoDec); 570 if (ret != AV_ERR_OK) { 571 // 异常处理 572 } 573 ``` 574 57517. 调用OH_VideoDecoder_Destroy()销毁解码器实例，释放资源。 576 577 > **说明：** 578 > 579 > 不能在回调函数中调用； 580 > 执行该步骤之后，需要调用者将videoDec指向NULL，防止野指针导致程序错误。 581 > 582 583 ```c++ 584 // 调用OH_VideoDecoder_Destroy，注销解码器 585 if (videoDec != NULL) { 586 int32_t ret = OH_VideoDecoder_Destroy(videoDec); 587 videoDec = NULL; 588 } 589 if (ret != AV_ERR_OK) { 590 // 异常处理 591 } 592 ``` 593 594### Buffer模式 595 596参考以下示例代码，调用者可以完成Buffer模式下视频解码的全流程。此处以H.264文件输入，解码成YUV文件为例。 597本模块目前仅支持异步模式的数据轮转。 598 5991. 添加头文件。 600 601 ```c++ 602 #include <multimedia/player_framework/native_avcodec_videodecoder.h> 603 #include <multimedia/player_framework/native_avcapability.h> 604 #include <multimedia/player_framework/native_avcodec_base.h> 605 #include <multimedia/player_framework/native_avformat.h> 606 #include <multimedia/player_framework/native_avbuffer.h> 607 #include <native_buffer/native_buffer.h> 608 #include <fstream> 609 ``` 610 6112. 创建解码器实例对象。 612 613 与Surface模式相同，此处不再赘述。 614 615 ```c++ 616 // 通过codecname创建解码器，应用有特殊需求，比如选择支持某种分辨率规格的解码器，可先查询capability，再根据codec name创建解码器。 617 OH_AVCapability *capability = OH_AVCodec_GetCapability(OH_AVCODEC_MIMETYPE_VIDEO_AVC, false); 618 const char *name = OH_AVCapability_GetName(capability); 619 OH_AVCodec *videoDec = OH_VideoDecoder_CreateByName(name); 620 ``` 621 622 ```c++ 623 // 通过MIME TYPE创建解码器，只能创建系统推荐的特定编解码器 624 // 涉及创建多路编解码器时，优先创建硬件解码器实例，硬件资源不够时再创建软件解码器实例 625 // 软/硬解: 创建H264解码器 626 OH_AVCodec *videoDec = OH_VideoDecoder_CreateByMime(OH_AVCODEC_MIMETYPE_VIDEO_AVC); 627 // 硬解: 创建H265解码器 628 OH_AVCodec *videoDec = OH_VideoDecoder_CreateByMime(OH_AVCODEC_MIMETYPE_VIDEO_HEVC); 629 ``` 630 6313. 调用OH_VideoDecoder_RegisterCallback()设置回调函数。 632 633 注册回调函数指针集合OH_AVCodecCallback，包括： 634 635 - OH_AVCodecOnError 解码器运行错误，返回的错误码详情请参见：[OH_AVCodecOnError](../../reference/apis-avcodec-kit/_codec_base.md#oh_avcodeconerror)； 636 - OH_AVCodecOnStreamChanged 码流信息变化，如码流宽、高变化； 637 - OH_AVCodecOnNeedInputBuffer 运行过程中需要新的输入数据，即解码器已准备好，可以输入数据； 638 - OH_AVCodecOnNewOutputBuffer 运行过程中产生了新的输出数据，即解码完成。 639 640 调用者可以通过处理该回调报告的信息，确保解码器正常运转。 641 642 <!--RP2--><!--RP2End--> 643 644 ```c++ 645 int32_t cropTop = 0; 646 int32_t cropBottom = 0; 647 int32_t cropLeft = 0; 648 int32_t cropRight = 0; 649 bool isFirstFrame = true; 650 // 解码异常回调OH_AVCodecOnError实现 651 static void OnError(OH_AVCodec *codec, int32_t errorCode, void *userData) 652 { 653 // 回调的错误码由调用者判断处理 654 (void)codec; 655 (void)errorCode; 656 (void)userData; 657 } 658 659 // 解码数据流变化回调OH_AVCodecOnStreamChanged实现 660 static void OnStreamChanged(OH_AVCodec *codec, OH_AVFormat *format, void *userData) 661 { 662 // 可选, 调用者需要获取视频宽、高、跨距等时可配置 663 // 可通过format获取到变化后的视频宽、高、跨距等 664 (void)codec; 665 (void)userData; 666 OH_AVFormat_GetIntValue(format, OH_MD_KEY_VIDEO_PIC_WIDTH, &width); 667 OH_AVFormat_GetIntValue(format, OH_MD_KEY_VIDEO_PIC_HEIGHT, &height); 668 OH_AVFormat_GetIntValue(format, OH_MD_KEY_VIDEO_STRIDE, &widthStride); 669 OH_AVFormat_GetIntValue(format, OH_MD_KEY_VIDEO_SLICE_HEIGHT, &heightStride); 670 // 获取裁剪矩形信息可选 671 OH_AVFormat_GetIntValue(format, OH_MD_KEY_VIDEO_CROP_TOP, &cropTop); 672 OH_AVFormat_GetIntValue(format, OH_MD_KEY_VIDEO_CROP_BOTTOM, &cropBottom); 673 OH_AVFormat_GetIntValue(format, OH_MD_KEY_VIDEO_CROP_LEFT, &cropLeft); 674 OH_AVFormat_GetIntValue(format, OH_MD_KEY_VIDEO_CROP_RIGHT, &cropRight); 675 } 676 677 // 解码输入回调OH_AVCodecOnNeedInputBuffer实现 678 static void OnNeedInputBuffer(OH_AVCodec *codec, uint32_t index, OH_AVBuffer *buffer, void *userData) 679 { 680 // 输入帧buffer对应的index，送入InIndexQueue队列 681 // 输入帧的数据buffer送入InBufferQueue队列 682 // 数据处理 683 // 写入解码码流 684 } 685 686 // 解码输出回调OH_AVCodecOnNewOutputBuffer实现 687 static void OnNewOutputBuffer(OH_AVCodec *codec, uint32_t index, OH_AVBuffer *buffer, void *userData) 688 { 689 // 可选, 调用者需要获取视频宽、高、跨距等时可配置 690 // 完成帧buffer对应的index，送入outIndexQueue队列 691 // 完成帧的数据buffer送入outBufferQueue队列 692 // 获取视频宽、高、跨距 693 if (isFirstFrame) { 694 OH_AVFormat *format = OH_VideoDecoder_GetOutputDescription(codec); 695 OH_AVFormat_GetIntValue(format, OH_MD_KEY_VIDEO_PIC_WIDTH, &width); 696 OH_AVFormat_GetIntValue(format, OH_MD_KEY_VIDEO_PIC_HEIGHT, &height); 697 OH_AVFormat_GetIntValue(format, OH_MD_KEY_VIDEO_STRIDE, &widthStride); 698 OH_AVFormat_GetIntValue(format, OH_MD_KEY_VIDEO_SLICE_HEIGHT, &heightStride); 699 // 获取裁剪矩形信息可选 700 OH_AVFormat_GetIntValue(format, OH_MD_KEY_VIDEO_CROP_TOP, &cropTop); 701 OH_AVFormat_GetIntValue(format, OH_MD_KEY_VIDEO_CROP_BOTTOM, &cropBottom); 702 OH_AVFormat_GetIntValue(format, OH_MD_KEY_VIDEO_CROP_LEFT, &cropLeft); 703 OH_AVFormat_GetIntValue(format, OH_MD_KEY_VIDEO_CROP_RIGHT, &cropRight); 704 OH_AVFormat_Destroy(format); 705 isFirstFrame = false; 706 } 707 // 数据处理 708 // 释放解码帧 709 } 710 // 配置异步回调，调用OH_VideoDecoder_RegisterCallback接口 711 OH_AVCodecCallback cb = {&OnError, &OnStreamChanged, &OnNeedInputBuffer, &OnNewOutputBuffer}; 712 // 配置异步回调 713 int32_t ret = OH_VideoDecoder_RegisterCallback(videoDec, cb, NULL); // NULL:用户特定数据userData为空 714 if (ret != AV_ERR_OK) { 715 // 异常处理 716 } 717 ``` 718 > **说明：** 719 > 720 > 在回调函数中，对数据队列进行操作时，需要注意多线程同步的问题。 721 > 722 7234. （可选）OH_VideoDecoder_SetDecryptionConfig设置解密配置。在获取到DRM信息(参考[音视频解封装](audio-video-demuxer.md)开发步骤第3步)，完成DRM许可证申请后，通过此接口进行解密配置。此接口需在Prepare前调用。在Buffer模式下，DRM解密能力仅支持非安全视频通路。DRM相关接口详见[DRM API文档](../../reference/apis-drm-kit/_drm.md)。 724 725 添加头文件。 726 727 ```c++ 728 #include <multimedia/drm_framework/native_mediakeysystem.h> 729 #include <multimedia/drm_framework/native_mediakeysession.h> 730 #include <multimedia/drm_framework/native_drm_err.h> 731 #include <multimedia/drm_framework/native_drm_common.h> 732 ``` 733 在 CMake 脚本中链接动态库。 734 735 ``` cmake 736 target_link_libraries(sample PUBLIC libnative_drm.so) 737 ``` 738 739 使用示例： 740 ```c++ 741 // 根据DRM信息创建指定的DRM系统, 以创建"com.clearplay.drm"为例 742 MediaKeySystem *system = nullptr; 743 int32_t ret = OH_MediaKeySystem_Create("com.clearplay.drm", &system); 744 if (system == nullptr) { 745 printf("create media key system failed"); 746 return; 747 } 748 749 // 创建解密会话 750 // 使用非安全视频通路，应创建CONTENT_PROTECTION_LEVEL_SW_CRYPTO及以上内容保护级别的MediaKeySession 751 MediaKeySession *session = nullptr; 752 DRM_ContentProtectionLevel contentProtectionLevel = CONTENT_PROTECTION_LEVEL_SW_CRYPTO; 753 ret = OH_MediaKeySystem_CreateMediaKeySession(system, &contentProtectionLevel, &session); 754 if (ret != DRM_OK) { 755 // 如创建失败，请查看DRM接口文档及日志信息 756 printf("create media key session failed."); 757 return; 758 } 759 if (session == nullptr) { 760 printf("media key session is nullptr."); 761 return; 762 } 763 // 获取许可证请求、设置许可证响应等 764 // 设置解密配置, 即将解密会话、安全视频通路标志设置到解码器中。 765 bool secureVideoPath = false; 766 ret = OH_VideoDecoder_SetDecryptionConfig(videoDec, session, secureVideoPath); 767 ``` 768 7695. 调用OH_VideoDecoder_Configure()配置解码器。 770 771 与Surface模式相同，此处不再赘述。 772 773 ```c++ 774 OH_AVFormat *format = OH_AVFormat_Create(); 775 // 写入format 776 OH_AVFormat_SetIntValue(format, OH_MD_KEY_WIDTH, width); 777 OH_AVFormat_SetIntValue(format, OH_MD_KEY_HEIGHT, height); 778 OH_AVFormat_SetIntValue(format, OH_MD_KEY_PIXEL_FORMAT, DEFAULT_PIXELFORMAT); 779 // 配置解码器 780 int32_t ret = OH_VideoDecoder_Configure(videoDec, format); 781 if (ret != AV_ERR_OK) { 782 // 异常处理 783 } 784 OH_AVFormat_Destroy(format); 785 ``` 786 7876. 调用OH_VideoDecoder_Prepare()解码器就绪。 788 789 该接口将在解码器运行前进行一些数据的准备工作。 790 791 ```c++ 792 int32_t ret = OH_VideoDecoder_Prepare(videoDec); 793 if (ret != AV_ERR_OK) { 794 // 异常处理 795 } 796 ``` 797 7987. 调用OH_VideoDecoder_Start()启动解码器。 799 800 ```c++ 801 std::string_view inputFilePath = "/*yourpath*.h264"; 802 std::string_view outputFilePath = "/*yourpath*.yuv"; 803 std::unique_ptr<std::ifstream> inputFile = std::make_unique<std::ifstream>(); 804 std::unique_ptr<std::ofstream> outputFile = std::make_unique<std::ofstream>(); 805 inputFile->open(inputFilePath.data(), std::ios::in | std::ios::binary); 806 outputFile->open(outputFilePath.data(), std::ios::out | std::ios::binary | std::ios::ate); 807 // 启动解码器，开始解码 808 int32_t ret = OH_VideoDecoder_Start(videoDec); 809 if (ret != AV_ERR_OK) { 810 // 异常处理 811 } 812 ``` 813 8148. （可选）调用OH_AVCencInfo_SetAVBuffer()，设置cencInfo。 815 816 与Surface模式相同，此处不再赘述。 817 818 使用示例： 819 ```c++ 820 uint32_t keyIdLen = DRM_KEY_ID_SIZE; 821 uint8_t keyId[] = { 822 0xd4, 0xb2, 0x01, 0xe4, 0x61, 0xc8, 0x98, 0x96, 823 0xcf, 0x05, 0x22, 0x39, 0x8d, 0x09, 0xe6, 0x28}; 824 uint32_t ivLen = DRM_KEY_IV_SIZE; 825 uint8_t iv[] = { 826 0xbf, 0x77, 0xed, 0x51, 0x81, 0xde, 0x36, 0x3e, 827 0x52, 0xf7, 0x20, 0x4f, 0x72, 0x14, 0xa3, 0x95}; 828 uint32_t encryptedBlockCount = 0; 829 uint32_t skippedBlockCount = 0; 830 uint32_t firstEncryptedOffset = 0; 831 uint32_t subsampleCount = 1; 832 DrmSubsample subsamples[1] = { {0x10, 0x16} }; 833 // 创建CencInfo实例 834 OH_AVCencInfo *cencInfo = OH_AVCencInfo_Create(); 835 if (cencInfo == nullptr) { 836 // 异常处理 837 } 838 // 设置解密算法 839 OH_AVErrCode errNo = OH_AVCencInfo_SetAlgorithm(cencInfo, DRM_ALG_CENC_AES_CTR); 840 if (errNo != AV_ERR_OK) { 841 // 异常处理 842 } 843 // 设置KeyId和Iv 844 errNo = OH_AVCencInfo_SetKeyIdAndIv(cencInfo, keyId, keyIdLen, iv, ivLen); 845 if (errNo != AV_ERR_OK) { 846 // 异常处理 847 } 848 // 设置Sample信息 849 errNo = OH_AVCencInfo_SetSubsampleInfo(cencInfo, encryptedBlockCount, skippedBlockCount, firstEncryptedOffset, 850 subsampleCount, subsamples); 851 if (errNo != AV_ERR_OK) { 852 // 异常处理 853 } 854 // 设置模式：KeyId、Iv和SubSamples已被设置 855 errNo = OH_AVCencInfo_SetMode(cencInfo, DRM_CENC_INFO_KEY_IV_SUBSAMPLES_SET); 856 if (errNo != AV_ERR_OK) { 857 // 异常处理 858 } 859 // 将CencInfo设置到AVBuffer中 860 errNo = OH_AVCencInfo_SetAVBuffer(cencInfo, buffer); 861 if (errNo != AV_ERR_OK) { 862 // 异常处理 863 } 864 // 销毁CencInfo实例 865 errNo = OH_AVCencInfo_Destroy(cencInfo); 866 if (errNo != AV_ERR_OK) { 867 // 异常处理 868 } 869 ``` 870 8719. 调用OH_VideoDecoder_PushInputBuffer()写入解码码流。 872 873 与Surface模式相同，此处不再赘述。 874 875 ```c++ 876 // 配置帧数据的输入尺寸、偏移量、时间戳等字段信息 877 OH_AVCodecBufferAttr info; 878 info.size = size; 879 info.offset = offset; 880 info.pts = pts; 881 info.flags = flags; 882 // info信息写入buffer 883 ret = OH_AVBuffer_SetBufferAttr(buffer, &info); 884 if (ret != AV_ERR_OK) { 885 // 异常处理 886 } 887 // 送入解码输入队列进行解码，index为对应队列下标 888 int32_t ret = OH_VideoDecoder_PushInputBuffer(videoDec, index); 889 if (ret != AV_ERR_OK) { 890 // 异常处理 891 } 892 ``` 893 89410. 调用OH_VideoDecoder_FreeOutputBuffer()释放解码帧。 895 896 以下示例中： 897 898 - index：回调函数OnNewOutputBuffer传入的参数，与buffer唯一对应的标识。 899 - buffer： 回调函数OnNewOutputBuffer传入的参数，可以通过OH_AVBuffer_GetAddr接口获取图像虚拟地址。 900 901 ```c++ 902 // 获取解码后信息 903 OH_AVCodecBufferAttr info; 904 int32_t ret = OH_AVBuffer_GetBufferAttr(buffer, &info); 905 if (ret != AV_ERR_OK) { 906 // 异常处理 907 } 908 // 将解码完成数据data写入到对应输出文件中 909 outputFile->write(reinterpret_cast<char *>(OH_AVBuffer_GetAddr(buffer)), info.size); 910 // Buffer模式，释放已完成写入的数据，index为对应buffer队列下标 911 ret = OH_VideoDecoder_FreeOutputBuffer(videoDec, index); 912 if (ret != AV_ERR_OK) { 913 // 异常处理 914 } 915 ``` 916 917 NV12/NV21图像如果需要依次将Y,U,V三个分量拷贝至另一块buffer中，以NV12图像为例，按行拷贝示例如下： 918 919 以NV12图像为例，width、height、wStride、hStride图像排布参考下图： 920 921 - OH_MD_KEY_VIDEO_PIC_WIDTH表示width； 922 - OH_MD_KEY_VIDEO_PIC_HEIGHT表示height； 923 - OH_MD_KEY_VIDEO_STRIDE表示wStride； 924 - OH_MD_KEY_VIDEO_SLICE_HEIGHT表示hStride。 925 926  927 928 添加头文件。 929 930 ```c++ 931 #include <string.h> 932 ``` 933 使用示例： 934 935 ```c++ 936 // 源内存区域的宽、高，通过回调函数OnStreamChanged或接口OH_VideoDecoder_GetOutputDescription获取 937 struct Rect 938 { 939 int32_t width; 940 int32_t height; 941 }; 942 943 struct DstRect // 目标内存区域的宽、高跨距，由调用者自行设置 944 { 945 int32_t wStride; 946 int32_t hStride; 947 }; 948 // 源内存区域的宽、高跨距，通过回调函数OnStreamChanged或接口OH_VideoDecoder_GetOutputDescription获取 949 struct SrcRect 950 { 951 int32_t wStride; 952 int32_t hStride; 953 }; 954 955 Rect rect = {320, 240}; 956 DstRect dstRect = {320, 240}; 957 SrcRect srcRect = {320, 256}; 958 uint8_t* dst = new uint8_t[dstRect.hStride * dstRect.wStride * 3 / 2]; // 目标内存区域的指针 959 uint8_t* src = new uint8_t[srcRect.hStride * srcRect.wStride]; // 源内存区域的指针 960 uint8_t* dstTemp = dst; 961 uint8_t* srcTemp = src; 962 963 // Y 将Y区域的源数据复制到另一个区域的目标数据中 964 for (int32_t i = 0; i < rect.height; ++i) { 965 //将源数据的一行数据复制到目标数据的一行中 966 memcpy_s(dstTemp, srcTemp, rect.width); 967 // 更新源数据和目标数据的指针，进行下一行的复制。每更新一次源数据和目标数据的指针都向下移动一个wStride 968 dstTemp += dstRect.wStride; 969 srcTemp += srcRect.wStride; 970 } 971 // padding 972 // 更新源数据和目标数据的指针，指针都向下移动一个padding 973 dstTemp += (dstRect.hStride - rect.height) * dstRect.wStride; 974 srcTemp += (srcRect.hStride - rect.height) * srcRect.wStride; 975 rect.height >>= 1; 976 // UV 将UV区域的源数据复制到另一个区域的目标数据中 977 for (int32_t i = 0; i < rect.height; ++i) { 978 memcpy_s(dstTemp, srcTemp, rect.width); 979 dstTemp += dstRect.wStride; 980 srcTemp += srcRect.wStride; 981 } 982 983 delete[] dst; 984 dst = nullptr; 985 delete[] src; 986 src = nullptr; 987 ``` 988 989 硬件解码在处理buffer数据时（释放数据前），输出回调调用者收到的AVbuffer是宽高对齐后的图像数据。 990 一般需要获取数据的宽高、跨距、像素格式来保证解码输出数据被正确的处理。 991 992 具体实现请参考：[Buffer模式](#buffer模式)的步骤3-调用OH_VideoDecoder_RegisterCallback()设置回调函数来获取数据的宽高、跨距、像素格式。 993 994后续流程（包括刷新解码器、重置解码器、停止解码器、销毁解码器）与Surface模式基本一致，请参考[Surface模式](#surface模式)的步骤14-17。 995 996<!--RP5--> 997<!--RP5End-->
