1# 视频编码 2 3开发者可以调用本模块的Native API接口，完成视频编码，即将未压缩的音视频数据压缩成音视频码流。 4 5当前支持的编码能力如下： 6 7| 容器规格 | 视频编码类型 | 音频编码类型 | 8| -------- | --------------------- | ---------------- | 9| mp4 | HEVC（H.265）、 AVC（H.264） | AAC、MPEG（MP3） | 10| m4a | HEVC（H.265）、 AVC（H.264） | AAC | 11 12## Surface输入与Buffer输入 13 14两者的数据来源不同。 15 16Surface输入包含了像素数据、像素格式等信息，如相机模块直接传入的录制视频流等。更适用于实时采集等场景。 17 18Buffer输入是指一块内存区域，一般为字节数组或指向内存的指针。更适用于从文件中读取音视频数据，或是实时流式传输等场景。 19 20在接口调用的过程中，两种方式的接口调用方式基本一致，但存在以下差异点： 21 221. Buffer模式下，应用调用OH_VideoEncoder_PushInputData()输入数据；Surface模式下，应用应在编码器启动前调用OH_VideoEncoder_GetSurface()，获取Surface用于传递视频数据。 23 242. Buffer模式下，应用调用OH_VideoEncoder_PushInputData()传入结束flag，编码器读取到尾帧后，停止编码；Surface模式下，需要调用OH_VideoEncoder_NotifyEndOfStream()通知编码器输入流结束。 25 26两种模式的开发步骤详细说明请参考：[Buffer模式](#buffer模式)和[Surface模式](#surface模式)。 27 28## 开发指导 29 30详细的API说明请参考[API文档](../reference/native-apis/_video_encoder.md)。 31如下为视频编码调用关系图： 32 33 34### 在 CMake 脚本中链接动态库 35``` cmake 36target_link_libraries(sample PUBLIC libnative_media_codecbase.so) 37target_link_libraries(sample PUBLIC libnative_media_core.so) 38target_link_libraries(sample PUBLIC libnative_media_venc.so) 39``` 40 41### Buffer模式 42 43参考以下示例代码，开发者可以完成Buffer输入模式下，视频编码的全流程。此处以YUV文件输入，编码成H.264格式为例。 44本模块目前仅支持异步模式的数据轮转。 45 461. 创建编码器实例对象。 47 48 应用可以通过名称或媒体类型创建编码器。 49 50 ``` c++ 51 // 通过 MIME TYPE 创建编码器，系统会根据MIME创建最合适的编码器。 52 OH_AVCodec *videoEnc = OH_VideoEncoder_CreateByMime(OH_AVCODEC_MIMETYPE_VIDEO_AVC); 53 ``` 54 55 ```c++ 56 // 通过codec name创建编码器，应用有特殊需求，比如选择支持某种分辨率规格的编码器，可先查询capability，再根据codec name创建编码器。 57 OH_AVCapability *capability = OH_AVCodec_GetCapability(OH_AVCODEC_MIMETYPE_VIDEO_AVC, true); 58 const char *codecName = OH_AVCapability_GetName(capability); 59 OH_AVCodec *videoEnc = OH_VideoEncoder_CreateByName(codecName); 60 ``` 61 622. 调用OH_VideoEncoder_SetCallback()设置回调函数。 63 64 > **注意：** 65 > 66 > 在回调函数中，对数据队列进行操作时，需要注意多线程冲突的问题。 67 68 注册回调函数指针集合OH_AVCodecAsyncCallback，包括： 69 70 - 编码器运行错误 71 - 码流信息变化，如声道变化等。 72 - 运行过程中需要新的输入数据，即编码器已准备好，可以输入PCM数据。 73 - 运行过程中产生了新的输出数据，即编码完成。 74 75 开发者可以通过处理该回调报告的信息，确保编码器正常运转。 76 77 ``` c++ 78 // 编码异常回调OH_AVCodecOnError实现 79 static void OnError(OH_AVCodec *codec, int32_t errorCode, void *userData) 80 { 81 (void)codec; 82 (void)errorCode; 83 (void)userData; 84 } 85 86 // 编码数据流变化回调OH_AVCodecOnStreamChanged实现 87 static void OnStreamChanged(OH_AVCodec *codec, OH_AVFormat *format, void *userData) 88 { 89 (void)codec; 90 (void)format; 91 (void)userData; 92 } 93 94 // 编码输入回调OH_AVCodecOnNeedInputData实现 95 static void OnNeedInputData(OH_AVCodec *codec, uint32_t index, OH_AVMemory *mem, void *userData) 96 { 97 (void)userData; 98 // 输入帧buffer对应的index，送入InIndexQueue队列 99 // 输入帧的数据mem送入InBufferQueue队列 100 // 数据处理，请参考: 101 // 7. 写入编码码流 102 // 8. 通知编码器码流结束 103 } 104 105 // 编码输出回调OH_AVCodecOnNewOutputData实现 106 static void OnNeedOutputData(OH_AVCodec *codec, uint32_t index, OH_AVMemory *mem, 107 OH_AVCodecBufferAttr *attr, void *userData) 108 { 109 (void)userData; 110 // 完成帧buffer对应的index，送入outIndexQueue队列 111 // 完成帧的数据mem送入outBufferQueue队列 112 // 完成帧的数据格式送入outAttrQueue队列 113 // 数据处理，请参考: 114 // 9. 输出编码帧 115 } 116 117 // 配置异步回调，调用 OH_VideoEncoder_SetCallback 接口 118 OH_AVCodecAsyncCallback cb = {&OnError, &OnStreamChanged, &OnNeedInputData, &OnNeedOutputData}; 119 int32_t ret = OH_VideoEncoder_SetCallback(videoEnc, cb, userData); 120 if (ret != AV_ERR_OK) { 121 // 异常处理 122 } 123 ``` 124 1253. 调用OH_VideoEncoder_Configure()配置编码器。 126 127 目前支持的所有格式都必须配置以下选项：视频帧宽度、视频帧高度、视频像素格式。 128 示例中的变量如下： 129 - DEFAULT_WIDTH：320像素宽度； 130 - DEFAULT_HEIGHT：240像素高度； 131 - DEFAULT_PIXELFORMAT： 像素格式，因为示例使用YUV的文件保存的像素格式是YUV420P，所以设置为 AV_PIXEL_FORMAT_YUVI420。 132 133 ``` c++ 134 // 配置视频帧宽度（必须） 135 constexpr uint32_t DEFAULT_WIDTH = 320; 136 // 配置视频帧高度（必须） 137 constexpr uint32_t DEFAULT_HEIGHT = 240; 138 // 配置视频像素格式（必须） 139 constexpr OH_AVPixelFormat DEFAULT_PIXELFORMAT = AV_PIXEL_FORMAT_YUVI420; 140 OH_AVFormat *format = OH_AVFormat_Create(); 141 // 写入format 142 OH_AVFormat_SetIntValue(format, OH_MD_KEY_WIDTH, DEFAULT_WIDTH); 143 OH_AVFormat_SetIntValue(format, OH_MD_KEY_HEIGHT, DEFAULT_HEIGHT); 144 OH_AVFormat_SetIntValue(format, OH_MD_KEY_PIXEL_FORMAT, DEFAULT_PIXELFORMAT); 145 // 配置编码器 146 int32_t ret = OH_VideoEncoder_Configure(videoEnc, format); 147 if (ret != AV_ERR_OK) { 148 // 异常处理 149 } 150 ``` 151 1524. 调用OH_VideoEncoder_Prepare()，编码器就绪。 153 154 该接口将在编码器运行前进行一些数据的准备工作。 155 156 ``` c++ 157 ret = OH_VideoEncoder_Prepare(videoEnc); 158 if (ret != AV_ERR_OK) { 159 // 异常处理 160 } 161 ``` 162 1635. 调用OH_VideoEncoder_Start()启动编码器，进入运行态。 164 165 启动编码器后，回调函数将开始响应事件。所以，需要先配置输入文件、输出文件。 166 167 ``` c++ 168 // 配置待编码文件路径 169 string_view inputFilePath = "/*yourpath*.yuv"; 170 string_view outputFilePath = "/*yourpath*.h264"; 171 std::unique_ptr<std::ifstream> inputFile = std::make_unique<std::ifstream>(); 172 std::unique_ptr<std::ofstream> outputFile = std::make_unique<std::ofstream>(); 173 inputFile->open(inputFilePath.data(), std::ios::in | std::ios::binary); 174 outputFile->open(outputFilePath.data(), std::ios::out | std::ios::binary | std::ios::ate); 175 // 启动编码器，开始编码 176 int32_t ret = OH_VideoEncoder_Start(videoEnc); 177 if (ret != AV_ERR_OK) { 178 // 异常处理 179 } 180 ``` 181 1826. （可选）动态配置编码器实例。 183 184 ``` c++ 185 OH_AVFormat *format = OH_AVFormat_Create(); 186 // 配置视频帧速率 187 double frameRate = 30.0; 188 // 配置视频YUV值范围标志 189 bool rangeFlag = false; 190 // 配置视频原色 191 int32_t primary = static_cast<int32_t>(OH_ColorPrimary::COLOR_PRIMARY_BT709); 192 // 配置传输特性 193 int32_t transfer = static_cast<int32_t>(OH_TransferCharacteristic::TRANSFER_CHARACTERISTIC_BT709); 194 // 配置最大矩阵系数 195 int32_t matrix = static_cast<int32_t>(OH_MaxtrixCoefficient::MATRIX_COEFFICIENT_IDENTITY); 196 // 配置编码Profile 197 int32_t profile = static_cast<int32_t>(OH_AVCProfile::AVC_PROFILE_BASELINE); 198 // 配置编码比特率模式 199 int32_t rateMode = static_cast<int32_t>(OH_VideoEncodeBitrateMode::CBR); 200 // 配置关键帧的间隔，单位为毫秒 201 int32_t iFrameInterval = 23000; 202 // 配置所需的编码质量。只有在恒定质量模式下配置的编码器才支持此配置 203 int32_t quality = 0; 204 // 配置比特率 205 int64_t bitRate = 3000000; 206 // 写入format 207 OH_AVFormat_SetDoubleValue(format, OH_MD_KEY_FRAME_RATE, frameRate); 208 OH_AVFormat_SetIntValue(format, OH_MD_KEY_RANGE_FLAG, rangeFlag); 209 OH_AVFormat_SetIntValue(format, OH_MD_KEY_COLOR_PRIMARIES, primary); 210 OH_AVFormat_SetIntValue(format, OH_MD_KEY_TRANSFER_CHARACTERISTICS, transfer); 211 OH_AVFormat_SetIntValue(format, OH_MD_KEY_MATRIX_COEFFICIENTS, matrix); 212 213 OH_AVFormat_SetIntValue(format, OH_MD_KEY_I_FRAME_INTERVAL, iFrameInterval); 214 OH_AVFormat_SetIntValue(format, OH_MD_KEY_PROFILE, profile); 215 OH_AVFormat_SetIntValue(format, OH_MD_KEY_VIDEO_ENCODE_BITRATE_MODE, rateMode); 216 OH_AVFormat_SetLongValue(format, OH_MD_KEY_BITRATE, bitRate); 217 OH_AVFormat_SetIntValue(format, OH_MD_KEY_QUALITY, quality); 218 219 int32_t ret = OH_VideoEncoder_SetParameter(videoEnc, format); 220 if (ret != AV_ERR_OK) { 221 // 异常处理 222 } 223 ``` 224 2257. 调用OH_VideoEncoder_PushInputData()，写入编码码流。 226 227 送入输入队列进行编码，以下示例中： 228 - GetOneFrameSize()：计算yuv文件帧长度的函数，具体的计算过程请参阅YUV相关资料。 229 - mem：回调函数OnNeedInputData传入的参数，可以通过OH_AVMemory_GetAddr接口得到共享内存地址的指针。 230 - index：回调函数OnNeedInputData传入的参数，数据队列的索引。 231 232 ``` c++ 233 // 处理文件流得到帧的长度，再将需要编码的数据写入到对应index的mem中 234 int32_t frameSize = GetOneFrameSize(); 235 inputFile->read(reinterpret_cast<char *>(OH_AVMemory_GetAddr(mem)), frameSize); 236 // 配置buffer info信息 237 OH_AVCodecBufferAttr info; 238 info.size = frameSize; 239 info.offset = 0; 240 info.pts = 0; 241 info.flags = AVCODEC_BUFFER_FLAGS_CODEC_DATA; 242 // 送入编码输入队列进行编码，index为对应输入队列的下标 243 int32_t ret = OH_VideoEncoder_PushInputData(videoEnc, index, info); 244 if (ret != AV_ERR_OK) { 245 // 异常处理 246 } 247 ``` 248 2498. 通知编码器码流结束。 250 251 以下示例中： 252 index：回调函数OnNeedInputData传入的参数，数据队列的索引。 253 与“步骤7.写入编码码流一样”，使用同一个接口OH_VideoEncoder_PushInputData，通知编码器输入结束，需要对flag标识成AVCODEC_BUFFER_FLAGS_EOS 254 255 ``` c++ 256 int32_t ret; 257 OH_AVCodecBufferAttr info; 258 info.size = 0; 259 info.offset = 0; 260 info.pts = 0; 261 info.flags = AVCODEC_BUFFER_FLAG_EOS; 262 ret = OH_VideoEncoder_PushInputData(videoEnc, index, info); 263 if (ret != AV_ERR_OK) { 264 // 异常处理 265 } 266 ``` 267 2689. 调用OH_VideoEncoder_FreeOutputData()，输出编码帧。 269 270 以下示例中： 271 - index：回调函数OnNeedOutputData传入的参数，数据队列的索引。 272 - attr：回调函数OnNeedOutputData传入的参数，输出数据的Buffer信息。 273 - mem： 回调函数OnNeedOutputData传入的参数，可以通过OH_AVMemory_GetAddr接口得到共享内存地址的指针。 274 275 ``` c++ 276 // 将编码完成帧数据mem写入到对应输出文件中 277 outputFile->write(reinterpret_cast<char *>(OH_AVMemory_GetAddr(mem)), attr->size); 278 // 释放已完成写入的数据，index为对应输出队列的下标 279 int32_t ret = OH_VideoEncoder_FreeOutputData(videoEnc, index); 280 if (ret != AV_ERR_OK) { 281 // 异常处理 282 } 283 ``` 284 28510. （可选）调用OH_VideoEncoder_Flush()刷新编码器。 286 287 调用OH_VideoEncoder_Flush()后，编码器仍处于运行态，但会将当前队列清空，将已编码的数据释放。 288 289 此时需要调用OH_VideoEncoder_Start()重新开始编码。 290 291 ``` c++ 292 int32_t ret; 293 // 刷新编码器videoEnc 294 ret = OH_VideoEncoder_Flush(videoEnc); 295 if (ret != AV_ERR_OK) { 296 // 异常处理 297 } 298 // 重新开始编码 299 ret = OH_VideoEncoder_Start(videoEnc); 300 if (ret != AV_ERR_OK) { 301 // 异常处理 302 } 303 ``` 304 30511. （可选）调用OH_VideoEncoder_Reset()重置编码器。 306 307 调用OH_VideoEncoder_Reset()后，编码器回到初始化的状态，需要调用OH_VideoEncoder_Configure()重新配置。 308 309 ``` c++ 310 int32_t ret; 311 // 重置编码器videoEnc 312 ret = OH_VideoEncoder_Reset(videoEnc); 313 if (ret != AV_ERR_OK) { 314 // 异常处理 315 } 316 // 重新配置编码器参数 317 ret = OH_VideoEncoder_Configure(videoEnc, format); 318 if (ret != AV_ERR_OK) { 319 // 异常处理 320 } 321 ``` 322 32312. 调用OH_VideoEncoder_Stop()停止编码器。 324 325 ``` c++ 326 int32_t ret; 327 // 终止编码器videoEnc 328 ret = OH_VideoEncoder_Stop(videoEnc); 329 if (ret != AV_ERR_OK) { 330 // 异常处理 331 } 332 ``` 333 33413. 调用OH_VideoEncoder_Destroy()销毁编码器实例，释放资源。 335 336 > **注意：** 337 > 338 > 执行该步骤之后，需要开发者将videoEnc指向nullptr，防止野指针导致程序错误。 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### Surface模式 351 352参考以下示例代码，开发者可以完成Surface输入模式下，视频编码的全流程。此处以视频数据输入，编码成H.264格式为例。 353本模块目前仅支持异步模式的数据轮转。 354 3551. 创建编码器实例对象。 356 357 应用可以通过名称或媒体类型创建编码器。 358 359 ``` c++ 360 // 通过 MIME TYPE 创建编码器，系统会根据MIME创建最合适的编码器。 361 OH_AVCodec *videoEnc = OH_VideoEncoder_CreateByMime(OH_AVCODEC_MIMETYPE_VIDEO_AVC); 362 ``` 363 364 ```c++ 365 // 通过codec name创建编码器，应用有特殊需求，比如选择支持某种分辨率规格的编码器，可先查询capability，再根据codec name创建编码器。 366 OH_AVCapability *capability = OH_AVCodec_GetCapability(OH_AVCODEC_MIMETYPE_VIDEO_AVC, true); 367 const char *codecName = OH_AVCapability_GetName(capability); 368 OH_AVCodec *videoEnc = OH_VideoEncoder_CreateByName(codecName); 369 ``` 370 3712. 调用OH_VideoEncoder_SetCallback()设置回调函数。 372 373 > **注意：** 374 > 375 > 在回调函数中，对数据队列进行操作时，需要注意多线程冲突的问题。 376 377 注册回调函数指针集合OH_AVCodecAsyncCallback，包括： 378 379 - 编码器运行错误 380 - 码流信息变化，如声道变化等。 381 - 运行过程中需要新的输入数据，即编码器已准备好，可以输入PCM数据。 382 - 运行过程中产生了新的输出数据，即编码完成。 383 384 ``` c++ 385 // 设置 OnError 回调函数 386 static void OnError(OH_AVCodec *codec, int32_t errorCode, void *userData) 387 { 388 (void)codec; 389 (void)errorCode; 390 (void)userData; 391 } 392 393 // 设置 OnStreamChanged 回调函数 394 static void OnStreamChanged(OH_AVCodec *codec, OH_AVFormat *format, void *userData) 395 { 396 (void)codec; 397 (void)format; 398 (void)userData; 399 } 400 401 // 设置 OnNeedInputData 回调函数，编码输入帧送入数据队列 402 static void OnNeedInputData(OH_AVCodec *codec, uint32_t index, OH_AVMemory *mem, void *userData) 403 { 404 (void)userData; 405 (void)index; 406 (void)mem; 407 // surface模式下，该回调函数无作用，用户通过配置的surface输入数据 408 } 409 410 // 设置 OnNeedOutputData 回调函数，编码完成帧送入输出队列 411 static void OnNeedOutputData(OH_AVCodec *codec, uint32_t index, OH_AVMemory *mem, 412 OH_AVCodecBufferAttr *attr, void *userData) 413 { 414 (void)userData; 415 // 完成帧buffer对应的index，送入outIndexQueue队列 416 // 完成帧的数据mem送入outBufferQueue队列 417 // 完成帧的数据格式送入outAttrQueue队列 418 // 数据处理，请参考: 419 // 10. 输出编码帧 420 } 421 422 // 配置异步回调，调用 OH_VideoEncoder_SetCallback 接口 423 OH_AVCodecAsyncCallback cb = {&OnError, &OnStreamChanged, &OnNeedInputData, &OnNeedOutputData}; 424 int32_t ret = OH_VideoEncoder_SetCallback(videoEnc, cb, userData); 425 if (ret != AV_ERR_OK) { 426 // 异常处理 427 } 428 ``` 429 4303. 调用OH_VideoEncoder_Configure()配置编码器。 431 432 目前支持的所有格式都必须配置以下选项：视频帧宽度、视频帧高度、视频像素格式。 433 示例中的变量如下： 434 - DEFAULT_WIDTH：320像素宽度； 435 - DEFAULT_HEIGHT：240像素高度； 436 - DEFAULT_PIXELFORMAT： 像素格式，因为示例使用YUV的文件保存的像素格式是YUV420P，所以设置为 AV_PIXEL_FORMAT_YUVI420。 437 438 ``` c++ 439 // 配置视频帧宽度（必须） 440 constexpr uint32_t DEFAULT_WIDTH = 320; 441 // 配置视频帧高度（必须） 442 constexpr uint32_t DEFAULT_HEIGHT = 240; 443 // 配置视频像素格式（必须） 444 constexpr OH_AVPixelFormat DEFAULT_PIXELFORMAT = AV_PIXEL_FORMAT_YUVI420; 445 OH_AVFormat *format = OH_AVFormat_Create(); 446 // 写入format 447 OH_AVFormat_SetIntValue(format, OH_MD_KEY_WIDTH, DEFAULT_WIDTH); 448 OH_AVFormat_SetIntValue(format, OH_MD_KEY_HEIGHT, DEFAULT_HEIGHT); 449 OH_AVFormat_SetIntValue(format, OH_MD_KEY_PIXEL_FORMAT, DEFAULT_PIXELFORMAT); 450 // 配置编码器 451 int32_t ret = OH_VideoEncoder_Configure(videoEnc, format); 452 if (ret != AV_ERR_OK) { 453 // 异常处理 454 } 455 ``` 456 4574. 调用OH_VideoEncoder_Prepare()，编码器就绪。 458 459 该接口将在编码器运行前进行一些数据的准备工作。 460 461 ``` c++ 462 ret = OH_VideoEncoder_Prepare(videoEnc); 463 if (ret != AV_ERR_OK) { 464 // 异常处理 465 } 466 ``` 467 4685. 获取Surface。 469 470 获取编码器Surface模式的OHNativeWindow输入，获取Surface需要在启动编码器之前完成。 471 472 ``` c++ 473 int32_t ret; 474 // 获取需要输入的Surface，以进行编码 475 OHNativeWindow *nativeWindow; 476 ret = OH_VideoEncoder_GetSurface(videoEnc, &nativeWindow); 477 if (ret != AV_ERR_OK) { 478 // 异常处理 479 } 480 // 通过OHNativeWindow*变量类型，配置输入数据的Surface 481 ``` 482 483 OHNativeWindow*变量类型的使用方法请参考图形子系统 [NativeWindow](../reference/native-apis/_native_window.md) 484 4856. 调用OH_VideoEncoder_Start()启动编码器。 486 487 ``` c++ 488 int32_t ret; 489 // 启动编码器，开始编码 490 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 // 配置视频帧速率 501 double frameRate = 30.0; 502 // 配置视频YUV值范围标志 503 bool rangeFlag = false; 504 // 配置视频原色 505 int32_t primary = static_cast<int32_t>(OH_ColorPrimary::COLOR_PRIMARY_BT709); 506 // 配置传输特性 507 int32_t transfer = static_cast<int32_t>(OH_TransferCharacteristic::TRANSFER_CHARACTERISTIC_BT709); 508 // 配置最大矩阵系数 509 int32_t matrix = static_cast<int32_t>(OH_MaxtrixCoefficient::MATRIX_COEFFICIENT_IDENTITY); 510 // 配置编码Profile 511 int32_t profile = static_cast<int32_t>(OH_AVCProfile::AVC_PROFILE_BASELINE); 512 // 配置编码比特率模式 513 int32_t rateMode = static_cast<int32_t>(OH_VideoEncodeBitrateMode::CBR); 514 // 配置关键帧的间隔，单位为毫秒 515 int32_t iFrameInterval = 23000; 516 // 配置所需的编码质量。只有在恒定质量模式下配置的编码器才支持此配置 517 int32_t quality = 0; 518 // 配置比特率 519 int64_t bitRate = 3000000; 520 // 写入format 521 OH_AVFormat_SetDoubleValue(format, OH_MD_KEY_FRAME_RATE, frameRate); 522 OH_AVFormat_SetIntValue(format, OH_MD_KEY_RANGE_FLAG, rangeFlag); 523 OH_AVFormat_SetIntValue(format, OH_MD_KEY_COLOR_PRIMARIES, primary); 524 OH_AVFormat_SetIntValue(format, OH_MD_KEY_TRANSFER_CHARACTERISTICS, transfer); 525 OH_AVFormat_SetIntValue(format, OH_MD_KEY_MATRIX_COEFFICIENTS, matrix); 526 527 OH_AVFormat_SetIntValue(format, OH_MD_KEY_I_FRAME_INTERVAL, iFrameInterval); 528 OH_AVFormat_SetIntValue(format, OH_MD_KEY_PROFILE, profile); 529 OH_AVFormat_SetIntValue(format, OH_MD_KEY_VIDEO_ENCODE_BITRATE_MODE, rateMode); 530 OH_AVFormat_SetLongValue(format, OH_MD_KEY_BITRATE, bitRate); 531 OH_AVFormat_SetIntValue(format, OH_MD_KEY_QUALITY, quality); 532 533 int32_t ret = OH_VideoEncoder_SetParameter(videoEnc, format); 534 if (ret != AV_ERR_OK) { 535 // 异常处理 536 } 537 ``` 538 5398. 写入编码码流。 540 541 在之前的第5步中，开发者已经对OH_VideoEncoder_GetSurface接口返回的OHNativeWindow*类型变量进行配置。 542 因为编码所需的数据，由配置的Surface进行持续地输入，所以开发者无需对OnNeedInputData回调函数进行处理，也无需使用OH_VideoEncoder_PushInputData接口输入数据。 543 5449. 调用OH_VideoEncoder_NotifyEndOfStream()通知编码器码流结束。 545 546 ``` c++ 547 int32_t ret; 548 // surface模式：通知视频编码器输入流已结束，只能使用此接口进行通知 549 // 不能像buffer模式中将flag设为AVCODEC_BUFFER_FLAGS_EOS，再调用OH_VideoEncoder_PushInputData接口通知编码器输入结束 550 ret = OH_VideoEncoder_NotifyEndOfStream(videoEnc); 551 if (ret != AV_ERR_OK) { 552 // 异常处理 553 } 554 ``` 555 55610. 调用OH_VideoEncoder_FreeOutputData()，输出编码帧。 557 558 以下示例中： 559 - index：回调函数OnNeedOutputData传入的参数，数据队列的索引。 560 - attr：回调函数OnNeedOutputData传入的参数，输出数据的Buffer信息。 561 - mem： 回调函数OnNeedOutputData传入的参数，可以通过OH_AVMemory_GetAddr接口得到共享内存地址的指针。 562 563 ``` c++ 564 // 将编码完成帧数据mem写入到对应输出文件中 565 outputFile->write(reinterpret_cast<char *>(OH_AVMemory_GetAddr(mem)), attr->size); 566 // 释放已完成写入的数据，index为对应输出队列下标 567 int32_t ret = OH_VideoEncoder_FreeOutputData(videoEnc, index); 568 if (ret != AV_ERR_OK) { 569 // 异常处理 570 } 571 ``` 572 573后续流程（包括刷新编码器、重置编码器、停止编码器、销毁编码器）与Buffer模式一致，请参考[Buffer模式](#buffer模式)的步骤9-12。 574
