• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 创建视频解码器和NativeWindow初始化并行
2
3## 场景介绍
4
5为了解码Surface模式的正常创建，在XComponent尚未创建或OpenGL后处理（NativeImage）尚未初始化的情况下，可以创建一个空的surface，以确保视频解码器能够正常创建和运行。
6
7
8## 开发步骤
9
10以下步骤描述了在surface的消费端没有创建之前，如何并行创建视频解码器和NativeWindow，让视频解码器正常创建执行。
11
12**添加动态链接库**
13
14``` cmake
15target_link_libraries(sample PUBLIC libnative_image.so)
16target_link_libraries(sample PUBLIC libnative_window.so)
17target_link_libraries(sample PUBLIC libnative_buffer.so)
18target_link_libraries(sample PUBLIC libnative_media_vdec.so)
19```
20
21> **说明：**
22>
23> 上述'sample'字样仅为示例，此处由开发者根据实际工程目录自定义。
24>
25
26**头文件**
27
28```c++
29#include <iostream>
30#include <string>
31#include <native_image/native_image.h>
32#include <native_window/external_window.h>
33#include <native_buffer/native_buffer.h>
34#include <multimedia/player_framework/native_avcodec_videodecoder.h>
35```
36
371. 创建OH_NativeImage实例。
38
39    ```c++
40    // 创建NativeImage实例，作为surface的消费者。
41    OH_NativeImage* image = OH_ConsumerSurface_Create();
42    ```
43
442. 获取对应的数据生产者端NativeWindow。
45
46    ```c++
47    // 获取生产者NativeWindow。
48    OHNativeWindow* nativeImageWindow = OH_NativeImage_AcquireNativeWindow(image);
49    ```
50
513. 设置NativeWindow的宽高。
52
53    ```c++
54    int code = SET_BUFFER_GEOMETRY;
55    int32_t width = 800;
56    int32_t height = 600;
57    int32_t ret = OH_NativeWindow_NativeWindowHandleOpt(nativeImageWindow, code, width, height);
58    if (ret != AV_ERR_OK) {
59        // 异常处理。
60    }
61    ```
62
634. 注册NativeImage的回调函数。
64
65    注册OH_NativeImage的监听者OH_OnFrameAvailableListener，包括：
66
67    - context 用户自定义的上下文信息；
68    - onFrameAvailable 有buffer可获取触发时的回调函数。
69
70    ```c++
71    // onFrameAvailable实现。
72    static void onFrameAvailable()
73    {
74      OHNativeWindowBuffer *buffer = nullptr;
75      int fenceFd;
76      // 通过消费端的OH_NativeImage获取一个OHNativeWindowBuffer。
77      OH_NativeImage_AcquireNativeWindowBuffer(image, &buffer, &fenceFd);
78      // 通过OH_NativeImage实例将OHNativeWindowBuffer归还到buffer队列中。
79      OH_NativeImage_ReleaseNativeWindowBuffer(image, &buffer, &fenceFd);
80    }
81
82    static void context()
83    {
84      // 开发者自定义的上下文信息。
85    }
86
87    // 设置回调监听者。
88    OH_OnFrameAvailableListener listener = {&onFrameAvailable, &context};
89    // 设置帧可用回调。
90    ret = OH_NativeImage_SetOnFrameAvailableListener(image, listener);
91    if (ret != AV_ERR_OK) {
92        // 异常处理。
93    }
94    ```
95
96    > **说明：**
97    >
98    > 在此示例中，回调函数的实现仅仅是将buffer取出来并释放，开发者可以根据业务需求自行拓展。
99    >
100
1015. 配置解码器。
102
103    具体开发指导请参考[视频解码Surface模式](video-decoding.md#surface模式)“步骤-5：调用OH_VideoDecoder_Configure()配置解码器”。
104
1056. 设置surface。
106
107    在应用业务真正的surface消费端创建成功之前，可以先使用上面临时创建的消费端连接解码器。
108
109    示例中的变量说明如下：
110    - videoDec：视频解码器实例的指针。创建方式可参考[视频解码Surface模式](video-decoding.md#surface模式)“步骤-2：创建解码器实例对象”。
111
112    ```c++
113
114    ret = OH_VideoDecoder_SetSurface(videoDec, nativeImageWindow);
115    if (ret != AV_ERR_OK) {
116        // 异常处理。
117    }
118    ```
119
1207. 启动解码器。
121
122    具体开发指导请参考[视频解码Surface模式](video-decoding.md#surface模式)“步骤-9：调用OH_VideoDecoder_Start()启动解码器”。
123
124
1258. 设置surface。
126
127    在应用业务真正的surface消费端创建成功后，可以调用OH_VideoDecoder_SetSurface接口，将解码输出重定向到新的surface上。
128
129    本例中的nativeWindow，有两种方式获取：
130    1. 如果解码后直接显示，则从XComponent组件获取，获取方式请参考 [XComponent](../../reference/apis-arkui/arkui-ts/ts-basic-components-xcomponent.md)；
131    2. 如果解码后接OpenGL后处理，则从NativeImage获取，获取方式请参考 [NativeImage](../../graphics/native-image-guidelines.md)。
132
133    ```c++
134
135    ret = OH_VideoDecoder_SetSurface(videoDec, nativeWindow);
136    if (ret != AV_ERR_OK) {
137        // 异常处理。
138    }
139    ```
140
1419. 销毁OH_NativeImage实例。
142
143   在调用OH_VideoDecoder_Destroy接口后，调用OH_NativeImage_Destroy接口销毁OH_NativeImage实例。
144   ```c++
145   // 销毁OH_NativeImage实例。
146   OH_NativeImage_Destroy(&image);
147   ```