1# 分段式拍照(C/C++)
2
3分段式拍照是相机的最重要功能之一，相机输出低质量图用作快速显示，提升用户感知拍照速度，同时使用高质量图保证最后的成图质量达到系统相机的水平，既满足了后处理算法的需求，又不阻塞前台的拍照速度，构筑相机性能竞争力，提升了用户的体验。
4
5- 在第一阶段，系统快速上报轻量处理的图片，轻量处理的图片比全质量图低，出图速度快。应用通过回调会收到一个PhotoAsset对象，通过该对象可调用媒体库接口，读取图片或落盘图片。
6- 在第二阶段，相机框架会根据应用的请求图片诉求或者在系统闲时，进行图像增强处理得到全质量图，将处理好的图片传回给媒体库，替换轻量处理的图片。
7
8## 开发步骤
9
10详细的API说明请参考[Camera API参考](../../reference/apis-camera-kit/_o_h___camera.md)。
11
121. 导入NDK接口，接口中提供了相机相关的属性和方法，导入方法如下。
13
14   ```c++
15    // 导入NDK接口头文件
16   #include <cstdint>
17   #include <cstdlib>
18   #include <cstring>
19   #include <string.h>
20   #include <memory>
21   #include "hilog/log.h"
22   #include "napi/native_api.h"
23   #include "camera_manager.h"
24   #include <multimedia/media_library/media_asset_manager_capi.h>
25   #include <multimedia/media_library/media_asset_change_request_capi.h>
26   #include <multimedia/media_library/media_access_helper_capi.h>
27   #include <multimedia/image_framework/image/image_packer_native.h>
28   ```
29
302. 在CMake脚本中链接相关动态库。
31
32   ```txt
33   target_link_libraries(entry PUBLIC
34       libace_napi.z.so
35       libhilog_ndk.z.so
36       libohcamera.so
37       libimage_source.so
38       libmedia_asset_manager.so
39       libimage_packer.so
40   )
41   ```
42
433. 相机初始化及拍照触发参考[拍照(C/C++)](./native-camera-shooting.md)。
44
454. 注册**分段式(PhotoAssetAvailable)**拍照回调，对比单端式拍照，仅注册的拍照回调接口不同。
46
47   > **注意：**
48   >
49   > 如果已经注册了PhotoAssetAvailable回调，并且在Session开始之后又注册了PhotoAvailable回调，PhotoAssetAvailable和PhotoAvailable同时注册，会导致流被重启，仅PhotoAssetAvailable生效。
50   >
51   > 不建议开发者同时注册PhotoAssetAvailable和PhotoAvailable。
52
53   注册PhotoAssetAvailableCallback回调，接收分段式拍照回图示例：
54
55   **分段式拍照开发流程（PhotoAssetAvailableCallback）**：
56
57   - 在会话commitConfig前注册分段式拍照回调。
58   - 通过分段式拍照回调，获取媒体库资源mediaAsset。
59   - 通过mediaAsset直接落盘图片或者通过mediaAsset配置策略模式请求图像资源，业务处理后通过buffer保存图片，或显示图片(参考[拍照(C/C++)](./native-camera-shooting.md)步骤5)。
60   - 使用完后解注册分段式拍照回调函数。
61
62   ```c++
63   // 方式一：调用媒体库落盘图片
64   void mediaLibSavePhoto(OH_MediaAsset *mediaAsset) {
65       if (mediaAsset == nullptr) {
66           OH_LOG_ERROR(LOG_APP, "mediaAsset is nullptr!");
67       }
68       // 创建媒体资产更改请求对象
69       OH_MediaAssetChangeRequest *changeRequest = OH_MediaAssetChangeRequest_Create(mediaAsset);
70       if (changeRequest == nullptr) {
71           OH_LOG_ERROR(LOG_APP, "changeRequest is nullptr!");
72       }
73       // 请求保存图片
74       MediaLibrary_ErrorCode errCode =
75           OH_MediaAssetChangeRequest_SaveCameraPhoto(changeRequest, MEDIA_LIBRARY_IMAGE_JPEG);
76       OH_LOG_INFO(LOG_APP, "SaveCameraPhoto get errCode:%{public}d", errCode);
77       // 发起请求
78       errCode = OH_MediaAccessHelper_ApplyChanges(changeRequest);
79       OH_LOG_INFO(LOG_APP, "ApplyChanges get errCode:%{public}d", errCode);
80   }
81
82   // 方式二：调用媒体库接口请求图像资源
83   // 图像源准备就绪时调用
84   OH_MediaAsset *g_mediaAsset_;
85   void OnImageDataPrepared(MediaLibrary_ErrorCode result, MediaLibrary_RequestId requestId,
86                            MediaLibrary_MediaQuality mediaQuality, MediaLibrary_MediaContentType type,
87                            OH_ImageSourceNative *imageSourceNative) {
88       if (imageSourceNative == nullptr) {
89           OH_LOG_ERROR(LOG_APP, "OnImageDataPrepared: imageSourceNative is nullptr!");
90           return;
91       }
92      if (mediaQuality == MediaLibrary_MediaQuality::MEDIA_LIBRARY_QUALITY_FAST) {
93           OH_LOG_INFO(LOG_APP, "OnImageDataPrepared: Using fast media quality.");
94       } else if (mediaQuality == MediaLibrary_MediaQuality::MEDIA_LIBRARY_QUALITY_FULL) {
95           OH_LOG_INFO(LOG_APP, "OnImageDataPrepared: Using full media quality.");
96       }
97       // 通过OH_ImageSourceNative创建OH_PixelmapNative
98       OH_PixelmapNative *pixelmapNative = nullptr;
99       OH_DecodingOptions *decodingOptions = nullptr;
100       Image_ErrorCode imageErr = IMAGE_SUCCESS;
101       imageErr = OH_ImageSourceNative_CreatePixelmap(imageSourceNative, decodingOptions, &pixelmapNative);
102       if (imageErr != IMAGE_SUCCESS) {
103           OH_LOG_ERROR(LOG_APP, "OnImageDataPrepared: CreatePixelmap failed.");
104           return;
105       }
106       // 创建Image Packer并设置打包选项
107       OH_ImagePackerNative *imagePacker;
108       OH_ImagePackerNative_Create(&imagePacker);
109       OH_PackingOptions *options;
110       OH_PackingOptions_Create(&options);
111       char format[] = "image/jpeg";
112       Image_MimeType image_MimeType = {format, strlen(format)};
113       OH_PackingOptions_SetMimeType(options, &image_MimeType);
114       OH_PackingOptions_SetQuality(options, 100); // 最高质量100
115       size_t bufferSize = 3072 * 4096; // 传大于编码后的size大小，编码后会重新赋值
116       // 解析出图片buffer
117       auto buffer = std::make_unique<uint8_t[]>(bufferSize);
118       imageErr = OH_ImagePackerNative_PackToDataFromPixelmap(imagePacker, options, pixelmapNative, buffer.get(), &bufferSize);
119       OH_LOG_INFO(LOG_APP, "OnImageDataPrepared: packToData ret code:%{public}u outsize:%{public}zu", imageErr, bufferSize);
120       if (g_mediaAsset_ == nullptr) {
121           OH_LOG_ERROR(LOG_APP,  "OnImageDataPrepared: get current mediaAsset failed!");
122       }
123       // 调用媒体库接口通过buffer存图
124       OH_MediaAssetChangeRequest *changeRequest = OH_MediaAssetChangeRequest_Create(g_mediaAsset_);
125       MediaLibrary_ErrorCode mediaErr = OH_MediaAssetChangeRequest_AddResourceWithBuffer(changeRequest,
126           MEDIA_LIBRARY_IMAGE_RESOURCE, buffer.get(), bufferSize);
127       OH_LOG_INFO(LOG_APP,  "OnImageDataPrepared: AddResourceWithBuffer get errCode:%{public}d", mediaErr);
128       mediaErr = OH_MediaAssetChangeRequest_SaveCameraPhoto(changeRequest, MEDIA_LIBRARY_IMAGE_JPEG);
129       OH_LOG_INFO(LOG_APP,  "OnImageDataPrepared: SaveCameraPhoto get errCode:%{public}d", mediaErr);
130       mediaErr = OH_MediaAccessHelper_ApplyChanges(changeRequest);
131       OH_LOG_INFO(LOG_APP,  "OnImageDataPrepared: ApplyChanges get errCode:%{public}d", mediaErr);
132   }
133
134   void mediaLibRequestBuffer(Camera_PhotoOutput *photoOutput, OH_MediaAsset *mediaAsset) {
135       if (photoOutput == nullptr) {
136           OH_LOG_ERROR(LOG_APP, "photoOutput is nullptr!");
137       }
138       if (mediaAsset == nullptr) {
139           OH_LOG_ERROR(LOG_APP, "mediaAsset is nullptr!");
140       }
141       // 创建媒体资产管理器
142       OH_MediaAssetManager *mediaAssetManager = OH_MediaAssetManager_Create();
143       if (mediaAssetManager == nullptr) {
144           OH_LOG_ERROR(LOG_APP, "mediaAssetManager is nullptr!");
145       }
146       // 配置请求媒体图片参数
147       MediaLibrary_RequestOptions requestOptions;
148       // 按照业务需求配置策略模式请求图像资源
149       // MEDIA_LIBRARY_FAST_MODE：仅接收一阶段低质量图回调
150       // MEDIA_LIBRARY_HIGH_QUALITY_MODE：仅接收二阶段全质量图回调
151       // MEDIA_LIBRARY_BALANCED_MODE：接收一阶段及二阶段图片回调
152       requestOptions.deliveryMode = MEDIA_LIBRARY_FAST_MODE;
153       MediaLibrary_RequestId requestId;
154       // 请求图像资源，图像源准备就绪时调用onImageDataPrepared
155       MediaLibrary_ErrorCode result = OH_MediaAssetManager_RequestImage(mediaAssetManager, mediaAsset, requestOptions, &requestId, OnImageDataPrepared);
156       if (result != MEDIA_LIBRARY_OK) {
157           OH_LOG_ERROR(LOG_APP, "OH_MediaAssetManager_RequestImage failed.");
158       }
159   }
160
161   // 分段式拍照回调函数
162   void OnPhotoAssetAvailable(Camera_PhotoOutput *photoOutput, OH_MediaAsset *mediaAsset) {
163       OH_LOG_INFO(LOG_APP, "OnPhotoAssetAvailable start!");
164       if (mediaAsset == nullptr) {
165           OH_LOG_ERROR(LOG_APP, "OnPhotoAssetAvailable mediaAsset nullptr!");
166       }
167       // 处理方式一：调用媒体库接口落盘图片，先保存一阶段图，二阶段图就绪后媒体库会主动帮应用替换落盘图片
168       //     mediaLibSavePhoto(mediaAsset);
169       // 处理方式二：调用媒体库接口请求图像资源，获取一阶段图或二阶段图buffer，业务处理后通过buffer存图
170       g_mediaAsset_ = mediaAsset;
171       mediaLibRequestBuffer(photoOutput, mediaAsset);
172   }
173
174   // 注册分段式拍照回调
175   Camera_ErrorCode PhotoOutputRegisterPhotoAssetAvailableCallback(Camera_PhotoOutput *photoOutput) {
176       Camera_ErrorCode ret = OH_PhotoOutput_RegisterPhotoAssetAvailableCallback(photoOutput, OnPhotoAssetAvailable);
177       if (ret != CAMERA_OK) {
178           OH_LOG_ERROR("OH_PhotoOutput_RegisterPhotoAssetAvailableCallback failed.");
179       }
180       return ret;
181   }
182   ```
183
184
185