huawei_nearbyservice 是华为提供的一个 Flutter 插件，用于在 Flutter 应用中集成华为的近距离服务（Nearby Service）。近距离服务允许设备在无需互联网连接的情况下，通过蓝牙、Wi-Fi 或 Wi-Fi Direct 进行数据传输和通信。

以下是如何在 Flutter 项目中使用 huawei_nearbyservice 插件的步骤：

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 huawei_nearbyservice 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  huawei_nearbyservice: ^x.x.x  # 请使用最新版本

然后运行 flutter pub get 来获取依赖。

2. 配置项目

2.1 Android 配置

在 android/app/build.gradle 文件中，确保 minSdkVersion 至少为 21：

defaultConfig {
    minSdkVersion 21
    targetSdkVersion 30
    ...
}

2.2 iOS 配置

在 ios/Runner/Info.plist 文件中，添加以下权限：

<key>NSBluetoothAlwaysUsageDescription</key>
<string>我们需要使用蓝牙来进行近场通信</string>
<key>NSBluetoothPeripheralUsageDescription</key>
<string>我们需要使用蓝牙来进行近场通信</string>
<key>NSLocalNetworkUsageDescription</key>
<string>我们需要使用本地网络来进行近场通信</string>

3. 初始化 Nearby Service

在你的 Flutter 应用中，首先需要初始化 NearbyService：

import 'package:huawei_nearbyservice/huawei_nearbyservice.dart';

void initNearbyService() async {
  await NearbyService.initService();
}

4. 发现设备

你可以使用 discover() 方法来发现附近的设备：

void discoverDevices() {
  NearbyService.discover(
    strategy: Strategy.P2P,
    onFound: (String endpointId, String endpointName, String serviceId) {
      print('Found device: $endpointName');
    },
    onLost: (String endpointId) {
      print('Lost device: $endpointId');
    },
  );
}

5. 广播设备

你可以使用 broadcast() 方法来广播你的设备：

void broadcastDevice() {
  NearbyService.broadcast(
    strategy: Strategy.P2P,
    serviceId: 'your_service_id',
    serviceName: 'your_service_name',
    onSuccess: () {
      print('Broadcasting started');
    },
    onFailure: (String error) {
      print('Broadcasting failed: $error');
    },
  );
}

6. 发送和接收数据

你可以使用 sendData() 方法向其他设备发送数据，并使用 onReceiveData 回调来接收数据：

void sendData(String endpointId, String data) {
  NearbyService.sendData(
    endpointId: endpointId,
    data: data,
    onSuccess: () {
      print('Data sent successfully');
    },
    onFailure: (String error) {
      print('Failed to send data: $error');
    },
  );
}

void receiveData() {
  NearbyService.onReceiveData = (String endpointId, String data) {
    print('Received data: $data from $endpointId');
  };
}

7. 停止服务

在不需要使用 Nearby Service 时，记得停止服务以释放资源：

void stopNearbyService() {
  NearbyService.stopService();
}

8. 处理权限

确保在应用中请求必要的权限，如蓝牙、Wi-Fi 等。可以使用 permission_handler 插件来处理权限请求。

import 'package:permission_handler/permission_handler.dart';

void requestPermissions() async {
  await Permission.bluetooth.request();
  await Permission.location.request();
  // 其他必要的权限
}

9. 完整示例

以下是一个简单的示例，展示了如何发现设备、广播设备、发送和接收数据：

import 'package:flutter/material.dart';
import 'package:huawei_nearbyservice/huawei_nearbyservice.dart';
import 'package:permission_handler/permission_handler.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: NearbyServiceDemo(),
    );
  }
}

class NearbyServiceDemo extends StatefulWidget {
  [@override](/user/override)
  _NearbyServiceDemoState createState() => _NearbyServiceDemoState();
}

class _NearbyServiceDemoState extends State<NearbyServiceDemo> {
  [@override](/user/override)
  void initState() {
    super.initState();
    initNearbyService();
    requestPermissions();
  }

  void initNearbyService() async {
    await NearbyService.initService();
  }

  void requestPermissions() async {
    await Permission.bluetooth.request();
    await Permission.location.request();
  }

  void discoverDevices() {
    NearbyService.discover(
      strategy: Strategy.P2P,
      onFound: (String endpointId, String endpointName, String serviceId) {
        print('Found device: $endpointName');
      },
      onLost: (String endpointId) {
        print('Lost device: $endpointId');
      },
    );
  }

  void broadcastDevice() {
    NearbyService.broadcast(
      strategy: Strategy.P2P,
      serviceId: 'your_service_id',
      serviceName: 'your_service_name',
      onSuccess: () {
        print('Broadcasting started');
      },
      onFailure: (String error) {
        print('Broadcasting failed: $error');
      },
    );
  }

  void sendData(String endpointId, String data) {
    NearbyService.sendData(
      endpointId: endpointId,
      data: data,
      onSuccess: () {
        print('Data sent successfully');
      },
      onFailure: (String error) {
        print('Failed to send data: $error');
      },
    );
  }

  void receiveData() {
    NearbyService.onReceiveData = (String endpointId, String data) {
      print('Received data: $data from $endpointId');
    };
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Huawei Nearby Service Demo'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            ElevatedButton(
              onPressed: discoverDevices,
              child: Text('Discover Devices'),
            ),
            ElevatedButton(
              onPressed: broadcastDevice,
              child: Text('Broadcast Device'),
            ),
            ElevatedButton(
              onPressed: () => sendData('endpoint_id', 'Hello, Nearby!'),
              child: Text('Send Data'),
            ),
          ],
        ),
      ),
    );
  }
}