Flutter近距离消息通信插件flutter_nearby_messages_api的使用

安装

首先，在您的pubspec.yaml文件中添加flutter_nearby_messages_api作为依赖项。

dependencies:
  flutter_nearby_messages_api: ^x.x.x

替换x.x.x为最新版本号。

iOS

获取并添加Google Cloud附近的messages API密钥到您的项目中。

nearbyMessagesApi.setAPIKey('API_KEY');

在ios/Runner/Info.plist文件中添加以下行：

<key>NSMicrophoneUsageDescription</key>
<string>麦克风用于监听来自附近设备的匿名令牌。</string>
<key>NSBluetoothAlwaysUsageDescription</key>
<string>应用程序需要访问蓝牙以发送和接收消息。</string>
<key>NSBluetoothPeripheralUsageDescription</key>
<string>通过蓝牙广播匿名令牌以发现附近设备。</string>

对于iOS 13及更高版本，请确保添加NSBluetoothAlwaysUsageDescription。对于早期版本的iOS，请添加NSBluetoothPeripheralUsageDescription。

Android

获取并添加Google Cloud附近的messages API密钥到您的项目中。

在AndroidManifest.xml文件中添加以下行：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.yourapp">
    <application ...>
        <meta-data
            android:name="com.google.android.nearby.messages.API_KEY"
            android:value="API_KEY" />
    </application>
</manifest>

替换API_KEY为您实际的API密钥。

示例

下面是一个完整的示例，展示了如何使用flutter_nearby_messages_api插件进行近距离消息通信。

import 'package:flutter/material.dart';
import 'dart:async';
import 'package:flutter_nearby_messages_api/flutter_nearby_messages_api.dart';

void main() => runApp(MyApp());

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

class _MyAppState extends State<MyApp> {
  FlutterNearbyMessagesApi nearbyMessagesApi = FlutterNearbyMessagesApi();

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  // 平台消息是异步的，因此我们初始化在一个异步方法中。
  Future<void> initPlatformState() async {
    // 配置iOS
    await nearbyMessagesApi.setAPIKey('API_KEY');

    // 当附近设备发送消息时调用此回调
    nearbyMessagesApi.onFound = (message) {
      print('~~~onFound : $message');
    };

    // 当附近设备离开时调用此回调
    nearbyMessagesApi.onLost = (message) {
      print('~~~onLost : $message');
    };

    // 监听发布和订阅的状态
    // 枚举 GNSOperationStatus {inactive, starting, active}
    nearbyMessagesApi.statusHandler = (status) {
      print('~~~statusHandler : $status');
    };

    // 使用您的消息来提示用户权限
    nearbyMessagesApi.setPermissionAlert(
        '您的标题', '您的消息', '拒绝', '允许');

    nearbyMessagesApi.permissionHandler = (status) {
      print(status);
    };

    nearbyMessagesApi.bluetoothPowerErrorHandler = (args) {
      print('~~~ bluetoothPowerErrorHandler');
    };

    nearbyMessagesApi.bluetoothPermissionErrorHandler = (args) {
      print('~~~ bluetoothPermissionErrorHandler');
    };

    nearbyMessagesApi.microphonePermissionErrorHandler = (args) {
      print('~~~ microphonePermissionErrorHandler');
    };

    // 发布一条消息
    // @require message
    await nearbyMessagesApi.publish('Hello world!');

    // 订阅
    await nearbyMessagesApi.backgroundSubscribe();

    // 启用调试模式
    await nearbyMessagesApi.enableDebugMode();

    // 禁用调试模式
    await nearbyMessagesApi.disableDebugMode();

    // 不要未经学习就使用它
    // nearbyMessagesApi.setNearbyAccessPermission(true);
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return new MaterialApp(
      home: new Scaffold(
        appBar: new AppBar(
          title: const Text('Flutter Nearby Messages 示例'),
        ),
        body: new Container(
          color: Colors.white70,
          child: new Column(children: [
            new TextButton(
                onPressed: () async {
                  await nearbyMessagesApi.publish('Hello world!');
                },
                child: new Text("发布")),
            new TextButton(
                onPressed: () async {
                  await nearbyMessagesApi.unPublish();
                },
                child: new Text("取消发布")),
            new TextButton(
                onPressed: () async {
                  await nearbyMessagesApi.backgroundSubscribe();
                },
                child: new Text("后台订阅")),
            new TextButton(
                onPressed: () async {
                  await nearbyMessagesApi.backgroundUnsubscribe();
                },
                child: new Text("取消订阅"))
          ]),
        ),
      ),
    );
  }
}