Flutter视频监控插件hikvision_flutter的使用

Flutter视频监控插件hikvision_flutter的使用

1. 概述

hikvision_flutter 是一个用于在 Flutter 应用中集成海康威视（HIKVISION）SDK 的封装插件。它允许开发者通过 Flutter 调用海康威视设备的功能，例如实时预览、录像回放等。

2. 公共要求

所有方法和参数在 Flutter 和原生代码之间通信时，必须使用 pigeon 自动生成代码。配置文件位于 pigeons/messages.dart。

3. iOS 平台配置

3.1 生成 pigeon 消息

运行以下命令生成 pigeon 文件：

flutter pub run pigeon \
    --input ./pigeons/messages.dart \
    --dart_out ./lib/platform_communication.dart \
    --dart_test_out ./test/platform_communication_test.dart \
    --objc_header_out ./ios/Classes/platform_communication.h \
    --objc_source_out ./ios/Classes/platform_communication.mm \
    --java_out ./android/src/main/kotlin/vn/zensho/hikvision/hikvision_flutter/PlatformCommunication.java \
    --java_package "vn.zensho.hikvision.hikvision_flutter"

3.2 注意事项

• 强制要求：必须使用 ObjectiveC++，不能使用 Swift（Swift 编译会出错）。
• 所有 .m 文件需要改为 .mm 文件（包括 example/ios/Runner/GeneratedPluginRegistrant.m）。
• 将海康威视 SDK 的所有头文件复制到项目目录下的 project/ios/Classes 文件夹。
• 将所有 SDK 的库文件复制到 project/ios/lib 文件夹，并确保文件名以 lib 开头（如 libHCNetSDK.a），否则需要重命名。
• 在 podspec 文件中添加以下内容：

s.vendored_libraries = 'lib/*.a'
s.framework = 'AVFoundation', 'OpenAL', 'CoreGraphics', 'OpenGLES', 'QuartzCore', 'AudioToolBox', 'VideoToolBox', 'CoreVideo', 'CoreMedia', 'Foundation', 'GLKit', 'UIKit'
s.library = 'iconv', 'bz2'

4. 示例代码

以下是一个完整的示例代码，展示如何在 Flutter 中使用 hikvision_flutter 插件进行录像回放。

4.1 示例代码结构

example/
├── lib/
│   ├── main.dart
│   └── playback_screen.dart
└── ios/
    └── Classes/
        └── platform_communication.mm

4.2 示例代码实现

example/lib/main.dart

import 'package:flutter/material.dart';
import 'package:hikvision_flutter_example/playback_screen.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized(); // 确保 Flutter 绑定初始化

  runApp(const PlaybackScreen()); // 启动录像回放界面
}

example/lib/playback_screen.dart

import 'package:flutter/material.dart';
import 'package:hikvision_flutter/hikvision_flutter.dart'; // 引入 hikvision_flutter 插件

class PlaybackScreen extends StatefulWidget {
  const PlaybackScreen({Key? key}) : super(key: key);

  [@override](/user/override)
  _PlaybackScreenState createState() => _PlaybackScreenState();
}

class _PlaybackScreenState extends State<PlaybackScreen> {
  String _playbackStatus = '未开始'; // 录像回放状态

  [@override](/user/override)
  void initState() {
    super.initState();
    _startPlayback(); // 初始化时启动录像回放
  }

  Future<void> _startPlayback() async {
    try {
      await HikvisionFlutter.startPlayback(
        deviceIP: '192.168.1.100', // 替换为实际设备 IP 地址
        port: 37777, // 替换为实际端口号
        username: 'admin', // 替换为实际用户名
        password: 'password', // 替换为实际密码
      );
      setState(() {
        _playbackStatus = '正在回放';
      });
    } catch (e) {
      setState(() {
        _playbackStatus = '回放失败: $e';
      });
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('海康威视录像回放示例'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              Text(_playbackStatus),
              ElevatedButton(
                onPressed: () {
                  _startPlayback(); // 点击按钮重新启动录像回放
                },
                child: const Text('重新开始回放'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}