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 <ohcamera/camera.h> 24 #include <ohcamera/photo_output.h> 25 #include <ohcamera/camera_manager.h> 26 #include <multimedia/media_library/media_asset_manager_capi.h> 27 #include <multimedia/media_library/media_asset_change_request_capi.h> 28 #include <multimedia/media_library/media_access_helper_capi.h> 29 #include <multimedia/image_framework/image/image_packer_native.h> 30 ``` 31 322. 在CMake脚本中链接相关动态库。 33 34 ```txt 35 target_link_libraries(entry PUBLIC 36 libace_napi.z.so 37 libhilog_ndk.z.so 38 libohcamera.so 39 libimage_source.so 40 libmedia_asset_manager.so 41 libimage_packer.so 42 ) 43 ``` 44 453. 相机初始化及拍照触发参考[拍照(C/C++)](./native-camera-shooting.md)。 46 474. 注册**分段式(PhotoAssetAvailable)**拍照回调，对比单端式拍照，仅注册的拍照回调接口不同。 48 49 > **注意：** 50 > 51 > 如果已经注册了PhotoAssetAvailable回调，并且在Session开始之后又注册了PhotoAvailable回调，PhotoAssetAvailable和PhotoAvailable同时注册，会导致流被重启，仅PhotoAssetAvailable生效。 52 > 53 > 不建议开发者同时注册PhotoAssetAvailable和PhotoAvailable。 54 55 注册PhotoAssetAvailableCallback回调，接收分段式拍照回图示例： 56 57 **分段式拍照开发流程（PhotoAssetAvailableCallback）**： 58 59 - 在会话commitConfig前注册分段式拍照回调。 60 - 通过分段式拍照回调，获取媒体库资源mediaAsset。 61 - 通过mediaAsset直接落盘图片或者通过mediaAsset配置策略模式请求图像资源，业务处理后通过buffer保存图片，或显示图片(参考[拍照(C/C++)](./native-camera-shooting.md)步骤5)。 62 - 使用完后解注册分段式拍照回调函数。 63 64 ```c++ 65 // 方式一：调用媒体库落盘图片。 66 void mediaLibSavePhoto(OH_MediaAsset* mediaAsset) { 67 if (mediaAsset == nullptr) { 68 OH_LOG_ERROR(LOG_APP, "mediaAsset is nullptr!"); 69 return; 70 } 71 // 创建媒体资产更改请求对象。 72 OH_MediaAssetChangeRequest* changeRequest = OH_MediaAssetChangeRequest_Create(mediaAsset); 73 if (changeRequest == nullptr) { 74 OH_LOG_ERROR(LOG_APP, "changeRequest is nullptr!"); 75 return; 76 } 77 // 请求保存图片。 78 MediaLibrary_ErrorCode errCode = 79 OH_MediaAssetChangeRequest_SaveCameraPhoto(changeRequest, MEDIA_LIBRARY_IMAGE_JPEG); 80 OH_LOG_INFO(LOG_APP, "SaveCameraPhoto get errCode:%{public}d", errCode); 81 // 发起请求。 82 errCode = OH_MediaAccessHelper_ApplyChanges(changeRequest); 83 OH_LOG_INFO(LOG_APP, "ApplyChanges get errCode:%{public}d", errCode); 84 } 85 86 // 方式二：调用媒体库接口请求图像资源。 87 // 图像源准备就绪时调用。 88 OH_MediaAsset* g_mediaAsset_; 89 void OnImageDataPrepared(MediaLibrary_ErrorCode result, MediaLibrary_RequestId requestId, 90 MediaLibrary_MediaQuality mediaQuality, MediaLibrary_MediaContentType type, 91 OH_ImageSourceNative* imageSourceNative) { 92 if (imageSourceNative == nullptr) { 93 OH_LOG_ERROR(LOG_APP, "OnImageDataPrepared: imageSourceNative is nullptr!"); 94 return; 95 } 96 if (mediaQuality == MediaLibrary_MediaQuality::MEDIA_LIBRARY_QUALITY_FAST) { 97 OH_LOG_INFO(LOG_APP, "OnImageDataPrepared: Using fast media quality."); 98 } else if (mediaQuality == MediaLibrary_MediaQuality::MEDIA_LIBRARY_QUALITY_FULL) { 99 OH_LOG_INFO(LOG_APP, "OnImageDataPrepared: Using full media quality."); 100 } 101 // 通过OH_ImageSourceNative创建OH_PixelmapNative。 102 OH_PixelmapNative* pixelmapNative = nullptr; 103 OH_DecodingOptions* decodingOptions = nullptr; 104 Image_ErrorCode imageErr = IMAGE_SUCCESS; 105 imageErr = OH_ImageSourceNative_CreatePixelmap(imageSourceNative, decodingOptions, &pixelmapNative); 106 if (imageErr != IMAGE_SUCCESS) { 107 OH_LOG_ERROR(LOG_APP, "OnImageDataPrepared: CreatePixelmap failed."); 108 return; 109 } 110 // 创建Image Packer并设置打包选项。 111 OH_ImagePackerNative* imagePacker; 112 OH_ImagePackerNative_Create(&imagePacker); 113 OH_PackingOptions* options; 114 OH_PackingOptions_Create(&options); 115 char format[] = "image/jpeg"; 116 Image_MimeType image_MimeType = {format, strlen(format)}; 117 OH_PackingOptions_SetMimeType(options, &image_MimeType); 118 OH_PackingOptions_SetQuality(options, 100); // 最高质量100。 119 size_t bufferSize = 3072 * 4096; // 传大于编码后的size大小，编码后会重新赋值。 120 // 解析出图片buffer。 121 auto buffer = std::make_unique<uint8_t[]>(bufferSize); 122 imageErr = OH_ImagePackerNative_PackToDataFromPixelmap(imagePacker, options, pixelmapNative, buffer.get(), &bufferSize); 123 OH_LOG_INFO(LOG_APP, "OnImageDataPrepared: packToData ret code:%{public}u outsize:%{public}zu", imageErr, bufferSize); 124 if (g_mediaAsset_ == nullptr) { 125 OH_LOG_ERROR(LOG_APP, "OnImageDataPrepared: get current mediaAsset failed!"); 126 return; 127 } 128 // 调用媒体库接口通过buffer存图。 129 OH_MediaAssetChangeRequest* changeRequest = OH_MediaAssetChangeRequest_Create(g_mediaAsset_); 130 MediaLibrary_ErrorCode mediaErr = OH_MediaAssetChangeRequest_AddResourceWithBuffer(changeRequest, 131 MEDIA_LIBRARY_IMAGE_RESOURCE, buffer.get(), bufferSize); 132 OH_LOG_INFO(LOG_APP, "OnImageDataPrepared: AddResourceWithBuffer get errCode:%{public}d", mediaErr); 133 mediaErr = OH_MediaAssetChangeRequest_SaveCameraPhoto(changeRequest, MEDIA_LIBRARY_IMAGE_JPEG); 134 OH_LOG_INFO(LOG_APP, "OnImageDataPrepared: SaveCameraPhoto get errCode:%{public}d", mediaErr); 135 mediaErr = OH_MediaAccessHelper_ApplyChanges(changeRequest); 136 OH_LOG_INFO(LOG_APP, "OnImageDataPrepared: ApplyChanges get errCode:%{public}d", mediaErr); 137 } 138 139 void mediaLibRequestBuffer(OH_MediaAsset* mediaAsset) { 140 if (mediaAsset == nullptr) { 141 OH_LOG_ERROR(LOG_APP, "mediaAsset is nullptr!"); 142 return; 143 } 144 // 创建媒体资产管理器。 145 OH_MediaAssetManager* mediaAssetManager = OH_MediaAssetManager_Create(); 146 if (mediaAssetManager == nullptr) { 147 OH_LOG_ERROR(LOG_APP, "mediaAssetManager is nullptr!"); 148 return; 149 } 150 // 配置请求媒体图片参数。 151 MediaLibrary_RequestOptions requestOptions; 152 // 按照业务需求配置策略模式请求图像资源。 153 // MEDIA_LIBRARY_FAST_MODE：仅接收一阶段低质量图回调。 154 // MEDIA_LIBRARY_HIGH_QUALITY_MODE：仅接收二阶段全质量图回调。 155 // MEDIA_LIBRARY_BALANCED_MODE：接收一阶段及二阶段图片回调。 156 requestOptions.deliveryMode = MEDIA_LIBRARY_FAST_MODE; 157 MediaLibrary_RequestId requestId; 158 // 请求图像资源，图像源准备就绪时调用onImageDataPrepared。 159 MediaLibrary_ErrorCode result = OH_MediaAssetManager_RequestImage(mediaAssetManager, mediaAsset, requestOptions, &requestId, OnImageDataPrepared); 160 if (result != MEDIA_LIBRARY_OK) { 161 OH_LOG_ERROR(LOG_APP, "OH_MediaAssetManager_RequestImage failed."); 162 } 163 } 164 165 // 分段式拍照回调函数。 166 void OnPhotoAssetAvailable(Camera_PhotoOutput* photoOutput, OH_MediaAsset* mediaAsset) { 167 OH_LOG_INFO(LOG_APP, "OnPhotoAssetAvailable start!"); 168 if (mediaAsset == nullptr) { 169 OH_LOG_ERROR(LOG_APP, "OnPhotoAssetAvailable mediaAsset nullptr!"); 170 return; 171 } 172 // 处理方式一：调用媒体库接口落盘图片，先保存一阶段图，二阶段图就绪后媒体库会主动帮应用替换落盘图片。 173 // mediaLibSavePhoto(mediaAsset); 174 // 处理方式二：调用媒体库接口请求图像资源，获取一阶段图或二阶段图buffer，业务处理后通过buffer存图。 175 g_mediaAsset_ = mediaAsset; 176 mediaLibRequestBuffer(mediaAsset); 177 } 178 179 // 注册分段式拍照回调。 180 Camera_ErrorCode PhotoOutputRegisterPhotoAssetAvailableCallback(Camera_PhotoOutput* photoOutput) { 181 Camera_ErrorCode ret = OH_PhotoOutput_RegisterPhotoAssetAvailableCallback(photoOutput, OnPhotoAssetAvailable); 182 if (ret != CAMERA_OK) { 183 OH_LOG_ERROR(LOG_APP, "OH_PhotoOutput_RegisterPhotoAssetAvailableCallback failed."); 184 } 185 return ret; 186 } 187 ``` 188 189 190