规范解读
GB/T28181-2022相对2016版，除了对H.265、AAC有了明确的说明外，快照也有了具体的要求。源设备向目标设备发送图像抓拍配置命令，携带传输路径、会话ID等信息。目标设备完成图像传输后,发送图像抓拍传输完成通知命令，采用IETF RFC 3428中的MESSAGE方法实现，图像格式宜使用JPEG，图像分辨率宜采用与主码流相同的分辨率。
具体流程如下图：
需要注意的是，MESSAGE消息头Content-type头域要求Content-type:Application/MANSCDP+xml。图像传输方式宜采用http，图像抓拍传输完成通知命令采用MANSCDP协议格式定义。
技术实现
本文以大牛直播SDK实现的Android平台GB28181设备接入模块为例，介绍下快照实现逻辑，需要注意的是，哪怕设备侧不回传，也需要具备快照能力，并保存为jpeg格式，然后按照gb28181规范要求，把采集到的图片，上传到国标平台侧。
先说外部驱动快照：
scss
/*
* MainActivity.java
* Author: daniusdk.com
*/
class ButtonCaptureImageListener implements View.OnClickListener {
public void onClick(View v) {
if (null == snap_shot_impl_) {
snap_shot_impl_ = new SnapShotImpl(image_path_, context_, handler_, libPublisher, snap_shot_publisher_);
snap_shot_impl_.start();
}
startLayerPostThread();
snap_shot_impl_.set_layer_post_thread(layer_post_thread_);
snap_shot_impl_.capture();
}
}SnapShotImpl实现如下：
ini
public SnapShotImpl(String dir, Context context, android.os.Handler handler,
SmartPublisherJniV2 lib_sdk, LibPublisherWrapper publisher) {
this.dir_ = dir;
if (context != null)
this.context_ = new WeakReference<>(context);
if (handler != null)
this.os_handler_ = new WeakReference<>(handler);
this.lib_sdk_ = lib_sdk;
this.publisher_ = publisher;
}调用capture()的时候，处理逻辑如下：
typescript
protected boolean capture(String file_name, boolean is_update_layers, String user_data) {
if (is_null_or_empty(file_name)) {
Log.e(TAG, "capture file name is null");
return false;
}
if (publisher_.empty()) {
if (!init_sdk_instance()) {
Log.e(TAG, "init_sdk_instance failed");
return false;
}
}
if (is_update_layers && layer_post_thread_ != null)
layer_post_thread_.update_layers();
boolean ret = publisher_.CaptureImage(0, 100, file_name, user_data);
if (ret)
update_sdk_instance_release_time();
return ret;
}其中init_sdk_instance()实现如下：
ini
protected boolean init_sdk_instance() {
if (!publisher_.empty())
return true;
Context context = application_context();
if (null == context)
return false;
if (null == lib_sdk_)
return false;
long handle = lib_sdk_.SmartPublisherOpen(context, 0, 3, 1920, 1080);
if (0 == handle) {
Log.e(TAG, "init_sdk_instance sdk open failed!");
return false;
}
lib_sdk_.SetSmartPublisherEventCallbackV2(handle, new SDKEventHandler(this));
lib_sdk_.SmartPublisherSetFPS(handle, 4);
publisher_.set(lib_sdk_, handle);
update_sdk_instance_release_time();
Log.i(TAG, "init_sdk_instance ok handle:" + handle);
return true;
}对接gb28181平台部分，快照状态定义：
arduino
public final static int INITIALIZATION_STATUS = 0; // 初始状态
public final static int CAPTURING_STATUS = 1; // 抓拍中
public final static int CAPTURE_COMPLETION_STATUS = 2; // 抓拍完成状态
public final static int UPLOADING_STATUS = 3; // 图像上传中状态
public final static int UPLOAD_COMPLETION_STATUS = 4; // 图像上传完成状态
public final static int ERROR_STATUS = 5; // 错误状态快照完成后，告知国标平台：
ini
public void notify_server(List<String> notified_files) {
ArrayList<String> snap_shot_list = new ArrayList(items_.size());
for (SnapItem i : items_) {
if (SnapItem.UPLOAD_COMPLETION_STATUS == i.status())
snap_shot_list.add(i.gb_snap_shot_file_id());
if (notified_files != null)
notified_files.add(i.file_name());
}
if (null == agent_)
return;
GBSIPAgent agent = agent_.get();
if (null == agent)
return;
agent.notifyUploadSnapShotFinished(from_user_name_, from_user_name_at_domain_, device_id_, this.session_id(), snap_shot_list);
}技术总结
GB28181-2022快照实现，最好是单独开个实例，帧率根据实际快照间隔或者要求，不需要全帧率投递，在不录像不实时回传的时候，也能实现快照逻辑，然后按照规范要求和国标平台侧的客制化诉求，把快照后的文件上传到国标平台。