Android平台GB28181设备接入侧如何实现GB28181-2022实时快照

规范解读

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规范要求，把采集到的图片，上传到国标平台侧。

先说外部驱动快照：

    /*
     * 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实现如下：

    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()的时候，处理逻辑如下：

    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()实现如下：

    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平台部分，快照状态定义：

        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; // 错误状态

快照完成后，告知国标平台：

        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快照实现，最好是单独开个实例，帧率根据实际快照间隔或者要求，不需要全帧率投递，在不录像不实时回传的时候，也能实现快照逻辑，然后按照规范要求和国标平台侧的客制化诉求，把快照后的文件上传到国标平台。