Flutter蓝牙连接管理插件watch_ble_connection_plugin的使用

Flutter蓝牙连接管理插件watch_ble_connection_plugin的使用

安装

Android

• 在应用级别的 build.gradle 文件中添加以下依赖：

  implementation 'com.google.android.gms:play-services-wearable:17.0.0'
  

• 确保 Wear OS 应用的 applicationId 与手机应用的 applicationId 相同。

iOS

• iOS 的部署目标必须至少为 14.0（适用于向 Apple Watch 发送表盘）。
• 启用应用的 bitcode 以支持。具体操作可参照这些说明来启用应用的 Apple Watch 支持。

如何使用

• 若要了解如何在可穿戴设备上访问发送的数据，请查看示例项目。
• 建议不要依赖于 iOS 上的即时数据传输，因为 applicationContext 会在低强度情况下才会更新应用和手表之间的值。

发送表盘

• 使用静态方法 WatchConnection.sendWatchface(String path); 发送单个表盘到 Apple Watch。
• 目前仅支持 iOS 平台上的 Apple Watch。

// 发送表盘文件路径
WatchConnection.sendWatchface("/var/.../Portrait.watchface");

发送消息

• 使用静态方法 WatchConnection.sendMessage(Map<String, dynamic> message); 发送单次消息。
• 在 Android 上，所有消息将使用路径 /MessageChannel。

// 发送消息
WatchConnection.sendMessage({
  "text": "Some text",
  "integerValue": 1
});

接收消息

• 使用静态方法 WatchConnection.listenForMessage; 注册一个消息监听器函数。
• 如果消息数据是字符串，则库会尝试将其转换为 JSON。如果该操作失败，消息数据将原样发送给监听器。

// 注册消息监听器
WatchListener.listenForMessage((msg) {
  print(msg);
});

设置数据项

• 使用静态方法 WatchConnection.setData(String path, Map<String, dynamic> message); 设置指定路径的数据项（使用 Wear OS 兼容的数据层路径）。
• 在 iOS 中，路径变量将作为应用程序上下文字典中的键。
• 数据传输不是即时的，而是在低强度时刻进行。仅用于设置低优先级信息。

// 设置数据
WatchConnection.setData("/actor/cage",{
    "name": "Nicolas Saputra",
    "awesomeRating": 100
});

监听数据事件

• 使用静态方法 WatchConnection.listenForDataLayer; 注册一个数据监听器函数。
• 如果数据是字符串，则库会尝试将其转换为 JSON。如果该操作失败，数据将原样发送给监听器。

// 监听数据
WatchListener.listenForDataLayer((data) {
  print(data);
});

注意事项

• 目前在 Android 上不支持嵌套数据结构。因此建议将复杂项目作为 JSON 字符串发送并在接收端解析。
• 支持的通信类型包括：
  • 字符串
  • 整数
  • 浮点数
  • 双精度浮点数
  • 长整型
  • 布尔值
  • 单一类型的列表（字符串、浮点数、整数或长整型）

示例代码

import 'package:flutter/material.dart';
import 'package:watch_ble_connection_plugin/watch_ble_connection_plugin.dart';

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

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

class _MyAppState extends State<MyApp> {
  late TextEditingController _controller;
  String value = '';

  [@override](/user/override)
  void initState() {
    super.initState();
    _controller = TextEditingController();

    // 注册消息监听器
    WatchListener.listenForMessage((msg) {
      print(msg);
    });

    // 注册数据监听器
    WatchListener.listenForDataLayer((msg) {
      print(msg);
    });
  }

  [@override](/user/override)
  void dispose() {
    _controller.dispose();
    super.dispose();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Example app'),
        ),
        body: Center(
          child: SingleChildScrollView(
            child: Column(
              mainAxisAlignment: MainAxisAlignment.center,
              crossAxisAlignment: CrossAxisAlignment.center,
              children: [
                TextField(
                  controller: _controller,
                  decoration: InputDecoration(border: InputBorder.none, labelText: 'Enter some text'),
                  onChanged: (String val) async {
                    setState(() {
                      value = val;
                    });
                  },
                ),
                OutlinedButton(
                  child: Text('Send message to Watch'),
                  onPressed: () {
                    primaryFocus?.unfocus(disposition: UnfocusDisposition.scope);
                    WatchConnection.sendMessage({"text": value});
                  },
                ),
                OutlinedButton(
                  child: Text('Set data on Watch'),
                  onPressed: () {
                    primaryFocus?.unfocus(disposition: UnfocusDisposition.scope);
                    WatchConnection.setData("message", {
                      "text": value != "" ? value : "test", // 确保我们至少有空字符串
                      "integerValue": 1,
                      "intList": [1, 2, 3],
                      "stringList": ["one", "two", "three"],
                      "floatList": [1.0, 2.4, 3.6],
                      "longList": []
                    });
                  },
                ),
              ],
            ),
          ),
        ),
      ),
    );
  }
}