1# 视频编码 2 3开发者可以调用本模块的Native API接口，完成视频编码，即将未压缩的视频数据压缩成视频码流。 4 5当前支持的编码能力如下： 6 7| 容器规格 | 视频编码类型 | 8| -------- | ---------------------------- | 9| mp4 | HEVC（H.265）、 AVC（H.264） | 10| m4a | HEVC（H.265）、 AVC（H.264） | 11 12目前仅支持硬件编码，基于MimeType创建编码器时，支持配置为H264 (OH_AVCODEC_MIMETYPE_VIDEO_AVC) 和 H265 (OH_AVCODEC_MIMETYPE_VIDEO_HEVC)。 13 14## Surface输入与Buffer输入 15 16两者的数据来源不同。 17 18Surface输入是指用OHNativeWindow来传递输入数据，可以与其他模块对接，例如相机模块。 19 20Buffer输入是指有一块预先分配好的内存区域，调用者需要将原始数据拷贝进这块内存区域中。更适用于从文件中读取视频数据等场景。 21 22在接口调用的过程中，两种方式的接口调用方式基本一致，但存在以下差异点： 23 241. Buffer模式下，应用调用OH_VideoEncoder_PushInputBuffer()输入数据；Surface模式下，应用应在编码器就绪前调用OH_VideoEncoder_GetSurface()，获取OHNativeWindow用于传递视频数据。 252. Buffer模式下，应用调用OH_VideoEncoder_PushInputBuffer()传入结束flag，编码器读取到尾帧后，停止编码；Surface模式下，需要调用OH_VideoEncoder_NotifyEndOfStream()通知编码器输入流结束。 26 27两种模式的开发步骤详细说明请参考：[Surface模式](#surface模式)和[Buffer模式](#buffer模式)。 28 29## 开发指导 30 31详细的API说明请参考[API文档](../../reference/apis-avcodec-kit/_video_encoder.md)。 32如下为视频编码调用关系图： 33 34 35### 在 CMake 脚本中链接动态库 36 37```cmake 38target_link_libraries(sample PUBLIC libnative_media_codecbase.so) 39target_link_libraries(sample PUBLIC libnative_media_core.so) 40target_link_libraries(sample PUBLIC libnative_media_venc.so) 41``` 42 43### Surface模式 44 45参考以下示例代码，开发者可以完成Surface模式下视频编码的全流程。此处以surface数据输入，编码成H.264格式为例。 46本模块目前仅支持异步模式的数据轮转。 47 481. 添加头文件。 49 50 ```cpp 51 #include <multimedia/player_framework/native_avcodec_videoencoder.h> 52 #include <multimedia/player_framework/native_avcapability.h> 53 #include <multimedia/player_framework/native_avcodec_base.h> 54 #include <multimedia/player_framework/native_avformat.h> 55 #include <multimedia/player_framework/native_avbuffer.h> 56 ``` 57 582. 创建编码器实例对象。 59 60 应用可以通过名称或媒体类型创建编码器。示例中的变量说明如下： 61 62 - videoEnc：视频编码器实例的指针； 63 - capability：编解码器能力查询实例的指针； 64 - OH_AVCODEC_MIMETYPE_VIDEO_AVC：AVC格式视频码流的名称。 65 66 ```c++ 67 // 通过codec name创建编码器，应用有特殊需求，比如选择支持某种分辨率规格的编码器，可先查询capability，再根据codec name创建编码器。 68 OH_AVCapability *capability = OH_AVCodec_GetCapability(OH_AVCODEC_MIMETYPE_VIDEO_AVC, true); 69 const char *codecName = OH_AVCapability_GetName(capability); 70 OH_AVCodec *videoEnc = OH_VideoEncoder_CreateByName(codecName); 71 ``` 72 73 ```c++ 74 // 通过 MIME TYPE 创建编码器，系统会根据MIME创建最合适的编码器。 75 OH_AVCodec *videoEnc = OH_VideoEncoder_CreateByMime(OH_AVCODEC_MIMETYPE_VIDEO_AVC); 76 ``` 77 783. 调用OH_VideoEncoder_RegisterCallback()设置回调函数。 79 80 > **说明：** 81 > 82 > 在回调函数中，对数据队列进行操作时，需要注意多线程同步的问题。 83 > 84 85 注册回调函数指针集合OH_AVCodecCallback，包括： 86 87 - 编码器运行错误； 88 - 码流信息变化，如格式变化等； 89 - 输入回调无作用，用户通过获取的surface输入数据； 90 - 运行过程中产生了新的输出数据，即编码完成。 91 92 ```c++ 93 // 设置 OnError 回调函数 94 static void OnError(OH_AVCodec *codec, int32_t errorCode, void *userData) 95 { 96 (void)codec; 97 (void)errorCode; 98 (void)userData; 99 } 100 101 // 设置 OnStreamChanged 回调函数 102 static void OnStreamChanged(OH_AVCodec *codec, OH_AVFormat *format, void *userData) 103 { 104 (void)codec; 105 (void)format; 106 (void)userData; 107 } 108 109 // 设置 OH_AVCodecOnNeedInputBuffer 回调函数，编码输入帧送入数据队列 110 static void OnNeedInputBuffer(OH_AVCodec *codec, uint32_t index, OH_AVBuffer *buffer, void *userData) 111 { 112 (void)userData; 113 (void)index; 114 (void)buffer; 115 // surface模式下，该回调函数无作用，用户通过获取的surface输入数据 116 } 117 118 // 设置 OH_AVCodecOnNewOutputBuffer 回调函数，编码完成帧送入输出队列 119 static void OnNewOutputBuffer(OH_AVCodec *codec, uint32_t index, OH_AVBuffer *buffer, void *userData) 120 { 121 // 完成帧buffer对应的index，送入outIndexQueue队列 122 // 完成帧的数据buffer送入outBufferQueue队列 123 // 数据处理，请参考: 124 // - 释放编码帧 125 } 126 127 // 配置异步回调，调用 OH_VideoEncoder_SetCallback 接口 128 OH_AVCodecCallback cb = {&OnError, &OnStreamChanged, &OnNeedInputBuffer, &OnNewOutputBuffer}; 129 int32_t ret = OH_VideoEncoder_RegisterCallback(videoEnc, cb, NULL); 130 if (ret != AV_ERR_OK) { 131 // 异常处理 132 } 133 ``` 134 1354. 调用OH_VideoEncoder_Configure()配置编码器。 136 137 详细可配置选项的说明请参考[变量](../../reference/apis-avcodec-kit/_codec_base.md#变量)。 138 目前支持的所有格式都必须配置以下选项：视频帧宽度、视频帧高度、视频颜色格式。示例中的变量如下： 139 140 - DEFAULT_WIDTH：320像素宽度； 141 - DEFAULT_HEIGHT：240像素高度； 142 - DEFAULT_PIXELFORMAT： 颜色格式，因为示例使用YUV的文件保存的颜色格式是NV12，所以设置为 AV_PIXEL_FORMAT_NV12。 143 144 ```c++ 145 // 配置视频帧宽度（必须） 146 constexpr uint32_t DEFAULT_WIDTH = 320; 147 // 配置视频帧高度（必须） 148 constexpr uint32_t DEFAULT_HEIGHT = 240; 149 // 配置视频颜色格式（必须） 150 constexpr OH_AVPixelFormat DEFAULT_PIXELFORMAT = AV_PIXEL_FORMAT_NV12; 151 // 配置视频帧速率 152 double frameRate = 30.0; 153 // 配置视频YUV值范围标志 154 bool rangeFlag = false; 155 // 配置视频原色 156 int32_t primary = static_cast<int32_t>(OH_ColorPrimary::COLOR_PRIMARY_BT709); 157 // 配置传输特性 158 int32_t transfer = static_cast<int32_t>(OH_TransferCharacteristic::TRANSFER_CHARACTERISTIC_BT709); 159 // 配置最大矩阵系数 160 int32_t matrix = static_cast<int32_t>(OH_MatrixCoefficient::MATRIX_COEFFICIENT_IDENTITY); 161 // 配置编码Profile 162 int32_t profile = static_cast<int32_t>(OH_AVCProfile::AVC_PROFILE_BASELINE); 163 // 配置编码比特率模式 164 int32_t rateMode = static_cast<int32_t>(OH_VideoEncodeBitrateMode::CBR); 165 // 配置关键帧的间隔，单位为毫秒 166 int32_t iFrameInterval = 23000; 167 // 配置所需的编码质量。只有在恒定质量模式下配置的编码器才支持此配置 168 int32_t quality = 0; 169 // 配置比特率 170 int64_t bitRate = 3000000; 171 172 OH_AVFormat *format = OH_AVFormat_Create(); 173 OH_AVFormat_SetIntValue(format, OH_MD_KEY_WIDTH, DEFAULT_WIDTH); 174 OH_AVFormat_SetIntValue(format, OH_MD_KEY_HEIGHT, DEFAULT_HEIGHT); 175 OH_AVFormat_SetIntValue(format, OH_MD_KEY_PIXEL_FORMAT, DEFAULT_PIXELFORMAT); 176 177 OH_AVFormat_SetDoubleValue(format, OH_MD_KEY_FRAME_RATE, frameRate); 178 OH_AVFormat_SetIntValue(format, OH_MD_KEY_RANGE_FLAG, rangeFlag); 179 OH_AVFormat_SetIntValue(format, OH_MD_KEY_COLOR_PRIMARIES, primary); 180 OH_AVFormat_SetIntValue(format, OH_MD_KEY_TRANSFER_CHARACTERISTICS, transfer); 181 OH_AVFormat_SetIntValue(format, OH_MD_KEY_MATRIX_COEFFICIENTS, matrix); 182 OH_AVFormat_SetIntValue(format, OH_MD_KEY_I_FRAME_INTERVAL, iFrameInterval); 183 OH_AVFormat_SetIntValue(format, OH_MD_KEY_PROFILE, profile); 184 OH_AVFormat_SetIntValue(format, OH_MD_KEY_VIDEO_ENCODE_BITRATE_MODE, rateMode); 185 OH_AVFormat_SetLongValue(format, OH_MD_KEY_BITRATE, bitRate); 186 OH_AVFormat_SetIntValue(format, OH_MD_KEY_QUALITY, quality); 187 int32_t ret = OH_VideoEncoder_Configure(videoEnc, format); 188 if (ret != AV_ERR_OK) { 189 // 异常处理 190 } 191 OH_AVFormat_Destroy(format); 192 ``` 193 1945. 调用OH_VideoEncoder_Prepare()编码器就绪。 195 196 该接口将在编码器运行前进行一些数据的准备工作。 197 198 ```c++ 199 ret = OH_VideoEncoder_Prepare(videoEnc); 200 if (ret != AV_ERR_OK) { 201 // 异常处理 202 } 203 ``` 204 2056. 获取Surface。 206 207 获取编码器Surface模式的OHNativeWindow输入，获取Surface需要在启动编码器之前完成。 208 209 ```c++ 210 int32_t ret; 211 // 获取需要输入的Surface，以进行编码 212 OHNativeWindow *nativeWindow; 213 ret = OH_VideoEncoder_GetSurface(videoEnc, &nativeWindow); 214 if (ret != AV_ERR_OK) { 215 // 异常处理 216 } 217 // 通过OHNativeWindow*变量类型，配置输入数据的Surface 218 ``` 219 220 OHNativeWindow*变量类型的使用方法请参考图形子系统 [OHNativeWindow](../../reference/apis-arkgraphics2d/_native_window.md#ohnativewindow) 221 2227. 调用OH_VideoEncoder_Start()启动编码器。 223 224 ```c++ 225 int32_t ret; 226 // 启动编码器，开始编码 227 ret = OH_VideoEncoder_Start(videoEnc); 228 if (ret != AV_ERR_OK) { 229 // 异常处理 230 } 231 ``` 232 2338. （可选）在运行过程中动态配置编码器参数。 234 235 ```c++ 236 OH_AVFormat *format = OH_AVFormat_Create(); 237 OH_AVFormat_SetIntValue(format, OH_MD_KEY_REQUEST_I_FRAME, true); //目前仅支持动态请求IDR帧 238 int32_t ret = OH_VideoEncoder_SetParameter(videoEnc, format); 239 if (ret != AV_ERR_OK) { 240 // 异常处理 241 } 242 ``` 243 2449. 写入编码码流。 245 在之前的第6步中，开发者已经对OH_VideoEncoder_GetSurface接口返回的OHNativeWindow*类型变量进行配置。因为编码所需的数据，由配置的Surface进行持续地输入，所以开发者无需对OnNeedInputBuffer回调函数进行处理，也无需使用OH_VideoEncoder_PushInputBuffer接口输入数据。 246 24710. 调用OH_VideoEncoder_NotifyEndOfStream()通知编码器码流结束。 248 249 ```c++ 250 int32_t ret; 251 // surface模式：通知视频编码器输入流已结束，只能使用此接口进行通知 252 // 不能像buffer模式中将flag设为AVCODEC_BUFFER_FLAGS_EOS，再调用OH_VideoEncoder_PushInputBuffer接口通知编码器输入结束 253 ret = OH_VideoEncoder_NotifyEndOfStream(videoEnc); 254 if (ret != AV_ERR_OK) { 255 // 异常处理 256 } 257 ``` 258 25911. 调用OH_VideoEncoder_FreeOutputBuffer()释放编码帧。 260 261 以下示例中： 262 263 - index：回调函数OnNewOutputBuffer传入的参数，数据队列的索引。 264 - buffer： 回调函数OnNewOutputBuffer传入的参数，可以通过OH_AVBuffer_GetAddr接口得到共享内存地址的指针。 265 266 ```c++ 267 int32_t ret; 268 // 获取解码后信息 269 OH_AVCodecBufferAttr info; 270 ret = OH_AVBuffer_GetBufferAttr(buffer, &info); 271 if (ret != AV_ERR_OK) { 272 // 异常处理 273 } 274 // 将编码完成帧数据mem写入到对应输出文件中 275 outputFile->write(reinterpret_cast<char *>(OH_AVBuffer_GetAddr(buffer)), info.size); 276 // 释放已完成写入的数据，index为对应输出队列下标 277 ret = OH_VideoEncoder_FreeOutputBuffer(videoEnc, index); 278 if (ret != AV_ERR_OK) { 279 // 异常处理 280 } 281 ``` 282 28312. （可选）调用OH_VideoEncoder_Flush()刷新编码器。 284 285 调用OH_VideoEncoder_Flush()后，编码器仍处于运行态，但会将当前队列清空，将已编码的数据释放。 286 287 此时需要调用OH_VideoEncoder_Start()重新开始编码。 288 289 ```c++ 290 int32_t ret; 291 // 刷新编码器videoEnc 292 ret = OH_VideoEncoder_Flush(videoEnc); 293 if (ret != AV_ERR_OK) { 294 // 异常处理 295 } 296 // 重新开始编码 297 ret = OH_VideoEncoder_Start(videoEnc); 298 if (ret != AV_ERR_OK) { 299 // 异常处理 300 } 301 ``` 302 30313. （可选）调用OH_VideoEncoder_Reset()重置编码器。 304 305 调用OH_VideoEncoder_Reset()后，编码器回到初始化的状态，需要调用OH_VideoEncoder_Configure()重新配置。 306 307 ```c++ 308 int32_t ret; 309 // 重置编码器videoEnc 310 ret = OH_VideoEncoder_Reset(videoEnc); 311 if (ret != AV_ERR_OK) { 312 // 异常处理 313 } 314 // 重新配置编码器参数 315 ret = OH_VideoEncoder_Configure(videoEnc, format); 316 if (ret != AV_ERR_OK) { 317 // 异常处理 318 } 319 ``` 320 32114. （可选）调用OH_VideoEncoder_Stop()停止编码器。 322 323 ```c++ 324 int32_t ret; 325 // 终止编码器videoEnc 326 ret = OH_VideoEncoder_Stop(videoEnc); 327 if (ret != AV_ERR_OK) { 328 // 异常处理 329 } 330 ``` 331 33215. 调用OH_VideoEncoder_Destroy()销毁编码器实例，释放资源。 333 334 > **说明：** 335 > 336 > 不能在回调函数中调用； 337 > 执行该步骤之后，需要开发者将videoEnc指向nullptr，防止野指针导致程序错误。 338 > 339 340 ```c++ 341 int32_t ret; 342 // 调用OH_VideoEncoder_Destroy，注销编码器 343 ret = OH_VideoEncoder_Destroy(videoEnc); 344 videoEnc = nullptr; 345 if (ret != AV_ERR_OK) { 346 // 异常处理 347 } 348 ``` 349 350### Buffer模式 351 352参考以下示例代码，开发者可以完成Buffer模式下视频编码的全流程。此处以YUV文件输入，编码成H.264格式为例。 353本模块目前仅支持异步模式的数据轮转。 354 3551. 添加头文件。 356 357 ```cpp 358 #include <multimedia/player_framework/native_avcodec_videoencoder.h> 359 #include <multimedia/player_framework/native_avcapability.h> 360 #include <multimedia/player_framework/native_avcodec_base.h> 361 #include <multimedia/player_framework/native_avformat.h> 362 #include <multimedia/player_framework/native_avbuffer.h> 363 ``` 364 3652. 创建编码器实例对象。 366 367 与surface模式相同，此处不再赘述。 368 369 ```c++ 370 // 通过codec name创建编码器，应用有特殊需求，比如选择支持某种分辨率规格的编码器，可先查询capability，再根据codec name创建编码器。 371 OH_AVCapability *capability = OH_AVCodec_GetCapability(OH_AVCODEC_MIMETYPE_VIDEO_AVC, true); 372 const char *codecName = OH_AVCapability_GetName(capability); 373 OH_AVCodec *videoEnc = OH_VideoEncoder_CreateByName(codecName); 374 ``` 375 376 ```c++ 377 // 通过 MIME TYPE 创建编码器，系统会根据MIME创建最合适的编码器。 378 OH_AVCodec *videoEnc = OH_VideoEncoder_CreateByMime(OH_AVCODEC_MIMETYPE_VIDEO_AVC); 379 ``` 380 3813. 调用OH_VideoEncoder_RegisterCallback()设置回调函数。 382 383 > **说明：** 384 > 385 > 在回调函数中，对数据队列进行操作时，需要注意多线程同步的问题。 386 > 387 388 注册回调函数指针集合OH_AVCodecCallback，包括： 389 390 - 编码器运行错误； 391 - 码流信息变化，如格式变化等； 392 - 运行过程中需要新的输入数据，即编码器已准备好，可以输入YUV/RGB数据； 393 - 运行过程中产生了新的输出数据，即编码完成。 394 395 开发者可以通过处理该回调报告的信息，确保编码器正常运转。 396 397 ```c++ 398 // 编码异常回调OH_AVCodecOnError实现 399 static void OnError(OH_AVCodec *codec, int32_t errorCode, void *userData) 400 { 401 (void)codec; 402 (void)errorCode; 403 (void)userData; 404 } 405 406 // 编码数据流变化回调OH_AVCodecOnStreamChanged实现 407 static void OnStreamChanged(OH_AVCodec *codec, OH_AVFormat *format, void *userData) 408 { 409 (void)codec; 410 (void)format; 411 (void)userData; 412 } 413 414 // 编码输入回调OH_AVCodecOnNeedInputBuffer实现 415 static void OnNeedInputBuffer(OH_AVCodec *codec, uint32_t index, OH_AVBuffer *buffer, void *userData) 416 { 417 // 输入帧buffer对应的index，送入InIndexQueue队列 418 // 输入帧的数据buffer送入InBufferQueue队列 419 // 数据处理，请参考: 420 // - 写入编码码流 421 // - 通知编码器码流结束 422 } 423 424 // 编码输出回调OH_AVCodecOnNewOutputBuffer实现 425 static void OnNewOutputBuffer(OH_AVCodec *codec, uint32_t index, OH_AVBuffer *buffer, void *userData) 426 { 427 // 完成帧buffer对应的index，送入outIndexQueue队列 428 // 完成帧的数据buffer送入outBufferQueue队列 429 // 数据处理，请参考: 430 // - 释放编码帧 431 } 432 433 // 配置异步回调，调用 OH_VideoEncoder_RegisterCallback 接口 434 OH_AVCodecCallback cb = {&OnError, &OnStreamChanged, &OnNeedInputBuffer, &OnNewOutputBuffer}; 435 int32_t ret = OH_VideoEncoder_RegisterCallback(videoEnc, cb, NULL); 436 if (ret != AV_ERR_OK) { 437 // 异常处理 438 } 439 ``` 440 441 4. 调用OH_VideoEncoder_Configure()配置编码器。 442 443 与surface模式相同，此处不再赘述。 444 445 ```c++ 446 // 配置视频帧宽度（必须） 447 constexpr uint32_t DEFAULT_WIDTH = 320; 448 // 配置视频帧高度（必须） 449 constexpr uint32_t DEFAULT_HEIGHT = 240; 450 // 配置视频颜色格式（必须） 451 constexpr OH_AVPixelFormat DEFAULT_PIXELFORMAT = AV_PIXEL_FORMAT_NV12; 452 453 OH_AVFormat *format = OH_AVFormat_Create(); 454 // 写入format 455 OH_AVFormat_SetIntValue(format, OH_MD_KEY_WIDTH, DEFAULT_WIDTH); 456 OH_AVFormat_SetIntValue(format, OH_MD_KEY_HEIGHT, DEFAULT_HEIGHT); 457 OH_AVFormat_SetIntValue(format, OH_MD_KEY_PIXEL_FORMAT, DEFAULT_PIXELFORMAT); 458 // 配置编码器 459 int32_t ret = OH_VideoEncoder_Configure(videoEnc, format); 460 if (ret != AV_ERR_OK) { 461 // 异常处理 462 } 463 OH_AVFormat_Destroy(format); 464 ``` 465 4665. 调用OH_VideoEncoder_Prepare()编码器就绪。 467 468 该接口将在编码器运行前进行一些数据的准备工作。 469 470 ```c++ 471 ret = OH_VideoEncoder_Prepare(videoEnc); 472 if (ret != AV_ERR_OK) { 473 // 异常处理 474 } 475 ``` 476 4776. 调用OH_VideoEncoder_Start()启动编码器，进入运行态。 478 479 启动编码器后，回调函数将开始响应事件。所以，需要先配置输入文件、输出文件。 480 481 ```c++ 482 // 配置待编码文件路径 483 std::string_view inputFilePath = "/*yourpath*.yuv"; 484 std::string_view outputFilePath = "/*yourpath*.h264"; 485 std::unique_ptr<std::ifstream> inputFile = std::make_unique<std::ifstream>(); 486 std::unique_ptr<std::ofstream> outputFile = std::make_unique<std::ofstream>(); 487 inputFile->open(inputFilePath.data(), std::ios::in | std::ios::binary); 488 outputFile->open(outputFilePath.data(), std::ios::out | std::ios::binary | std::ios::ate); 489 // 启动编码器，开始编码 490 int32_t ret = OH_VideoEncoder_Start(videoEnc); 491 if (ret != AV_ERR_OK) { 492 // 异常处理 493 } 494 ``` 495 4967. （可选）在运行过程中动态配置编码器参数。 497 498 ```c++ 499 OH_AVFormat *format = OH_AVFormat_Create(); 500 OH_AVFormat_SetIntValue(format, OH_MD_KEY_REQUEST_I_FRAME, true); //目前仅支持动态请求IDR帧 501 int32_t ret = OH_VideoEncoder_SetParameter(videoEnc, format); 502 if (ret != AV_ERR_OK) { 503 // 异常处理 504 } 505 ``` 506 5078. 调用OH_VideoEncoder_PushInputBuffer()写入编码码流。 508 509 送入输入队列进行编码，以下示例中： 510 511 - buffer：回调函数OnNeedInputBuffer传入的参数，可以通过OH_AVBuffer_GetAddr接口得到共享内存地址的指针； 512 - index：回调函数OnNeedInputBuffer传入的参数，数据队列的索引； 513 - flags：缓冲区标记的类别，请参考[OH_AVCodecBufferFlags](../../reference/apis-avcodec-kit/_core.md#oh_avcodecbufferflags) 514 - stride: 获取到的buffer数据的跨距。 515 516 ```c++ 517 if (stride == DEFAULT_WIDTH) { 518 // 处理文件流得到帧的长度，再将需要编码的数据写入到对应index的buffer中 519 int32_t frameSize = DEFAULT_WIDTH * DEFAULT_HEIGHT * 3 / 2; // NV12颜色格式下，每帧数据大小的计算公式 520 inputFile->read(reinterpret_cast<char *>(OH_AVBuffer_GetAddr(buffer)), frameSize); 521 } else { 522 // 如果跨距不等于宽，需要用户按照跨距进行偏移 523 } 524 // 配置buffer info信息 525 OH_AVCodecBufferAttr info; 526 info.size = frameSize; 527 info.offset = 0; 528 info.pts = 0; 529 info.flags = flags; 530 ret = OH_AVBuffer_SetBufferAttr(buffer, &info); 531 if (ret != AV_ERR_OK) { 532 // 异常处理 533 } 534 // 送入编码输入队列进行编码，index为对应输入队列的下标 535 int32_t ret = OH_VideoEncoder_PushInputBuffer(videoEnc, index); 536 if (ret != AV_ERR_OK) { 537 // 异常处理 538 } 539 ``` 540 541 硬件编码在处理buffer数据时（推送数据前），一般需要获取数据的宽高、跨距来保证编码输入数据被正确的处理，请参考图形子系统 [OH_NativeBuffer](../../reference/apis-arkgraphics2d/_o_h___native_buffer.md)。 542 543 ```c++ 544 // OH_NativeBuffer *可以通过图形模块的接口可以获取数据的宽高、跨距等信息。 545 OH_NativeBuffer *ohNativeBuffer = OH_AVBuffer_GetNativeBuffer(buffer); 546 if (ohNativeBuffer != nullptr) { 547 // 获取OH_NativeBuffer_Config结构体，包含OH_NativeBuffer的数据信息 548 OH_NativeBuffer_Config config; 549 OH_NativeBuffer_GetConfig(ohNativeBuffer, &config); 550 551 // 释放ohNativeBuffer 552 ret = OH_NativeBuffer_Unreference(ohNativeBuffer); 553 if (ret != AV_ERR_OK) { 554 // 异常处理 555 } 556 ohNativeBuffer = nullptr; 557 } 558 ``` 559 5609. 通知编码器码流结束。 561 562 以下示例中：index：回调函数OnNeedInputBuffer传入的参数，数据队列的索引。 563 564 与“8. 写入编码码流”一样，使用同一个接口OH_VideoEncoder_PushInputBuffer，通知编码器输入结束，需要对flag标识成AVCODEC_BUFFER_FLAGS_EOS 565 566 ```c++ 567 int32_t ret; 568 OH_AVCodecBufferAttr info; 569 info.size = 0; 570 info.offset = 0; 571 info.pts = 0; 572 info.flags = AVCODEC_BUFFER_FLAGS_EOS; 573 ret = OH_AVBuffer_SetBufferAttr(buffer, &info); 574 if (ret != AV_ERR_OK) { 575 // 异常处理 576 } 577 ret = OH_VideoEncoder_PushInputBuffer(videoEnc, index, info); 578 if (ret != AV_ERR_OK) { 579 // 异常处理 580 } 581 ``` 582 58310. 调用OH_VideoEncoder_FreeOutputBuffer()释放编码帧。 584 与surface模式相同，此处不再赘述。 585 586 ```c++ 587 int32_t ret; 588 // 获取解码后信息 589 OH_AVCodecBufferAttr info; 590 ret = OH_AVBuffer_GetBufferAttr(buffer, &info); 591 if (ret != AV_ERR_OK) { 592 // 异常处理 593 } 594 // 将编码完成帧数据buffer写入到对应输出文件中 595 outputFile->write(reinterpret_cast<char *>(OH_AVBuffer_GetAddr(buffer)), info.size); 596 // 释放已完成写入的数据，index为对应输出队列的下标 597 ret = OH_VideoEncoder_FreeOutputBuffer(videoEnc, index); 598 if (ret != AV_ERR_OK) { 599 // 异常处理 600 } 601 ``` 602 603后续流程（包括刷新编码器、重置编码器、停止编码器、销毁编码器）与Surface模式一致，请参考[Surface模式](#surface模式)的步骤12-15。 604
