// onFrameAvailable实现。
static void onFrameAvailable()
{
  OHNativeWindowBuffer *buffer = nullptr;
  int fenceFd;
  // 通过消费端的OH_NativeImage获取一个OHNativeWindowBuffer。
  OH_NativeImage_AcquireNativeWindowBuffer(image, &buffer, &fenceFd);
  // 通过OH_NativeImage实例将OHNativeWindowBuffer归还到buffer队列中。
  OH_NativeImage_ReleaseNativeWindowBuffer(image, buffer, fenceFd);
}

static void context()
{
  // 开发者自定义的上下文信息。
}

// 设置回调监听者。
OH_OnFrameAvailableListener listener = {&onFrameAvailable, &context};
// 设置帧可用回调。
ret = OH_NativeImage_SetOnFrameAvailableListener(image, listener);
if (ret != AV_ERR_OK) {
    // 异常处理。
}

在此示例中，回调函数的实现仅仅是将buffer取出来并释放，开发者可以根据业务需求自行拓展。

配置解码器。

具体开发指导请参考视频解码Surface模式“步骤-5：调用OH_VideoDecoder_Configure()配置解码器”。
设置surface。

在应用业务真正的surface消费端创建成功之前，可以先使用上面临时创建的消费端连接解码器。

示例中的变量说明如下：
- videoDec：视频解码器实例的指针。创建方式可参考视频解码Surface模式“步骤-2：创建解码器实例对象”。
```
ret = OH_VideoDecoder_SetSurface(videoDec, nativeImageWindow);
if (ret != AV_ERR_OK) {
    // 异常处理。
}
```
启动解码器。

具体开发指导请参考视频解码Surface模式“步骤-8：调用OH_VideoDecoder_Start()启动解码器”。
设置surface。

在应用业务真正的surface消费端创建成功后，可以调用OH_VideoDecoder_SetSurface接口，将解码输出重定向到新的surface上。

本例中的nativeWindow，有两种方式获取：
1. 如果解码后直接显示，则从XComponent组件获取，获取方式请参考 XComponent；
2. 如果解码后接OpenGL后处理，则从NativeImage获取，获取方式请参考 NativeImage。
```
ret = OH_VideoDecoder_SetSurface(videoDec, nativeWindow);
if (ret != AV_ERR_OK) {
    // 异常处理。
}
```
取消NativeImage的回调监听并销毁OH_NativeImage实例。

在调用OH_VideoDecoder_Destroy接口后，调用OH_NativeImage_UnsetOnFrameAvailableListener接口取消帧可用回调监听，再调用OH_NativeImage_Destroy接口销毁OH_NativeImage实例。
```
// 取消帧可用回调监听。
ret = OH_NativeImage_UnsetOnFrameAvailableListener(image);
if (ret != AV_ERR_OK) {
   // 异常处理。
}

// 销毁OH_NativeImage实例。
OH_NativeImage_Destroy(&image);
```

目录

创建视频解码器和NativeWindow初始化并行

场景介绍

开发步骤