Flutter苹果手表连接性检测插件flutter_watch_os_connectivity的使用

发布于 1周前 作者 zlyuanteng 来自 Flutter

Flutter苹果手表连接性检测插件flutter_watch_os_connectivity的使用

概述

flutter_watch_os_connectivity是一个Flutter插件，它提供了一个包装器，使得Flutter应用程序能够与运行在WatchOS上的应用程序进行通信。该插件支持iOS平台，并提供了丰富的功能如发送消息、更新应用程序上下文、发送用户信息数据、文件传输等。

主要功能

  • 与WatchOS应用程序通信。
  • 发送消息。
  • 更新应用程序上下文。
  • 发送用户信息数据。
  • 文件传输。
  • 获取可穿戴设备信息。
  • 检测可穿戴设备的可达性。

开始使用

配置

iOS配置

  1. 创建一个WatchOS伴侣应用，可以按照这个教程创建新的WatchOS应用。
    • 注意：如果你已经用UIKit创建了WatchOS应用，则WatchOS伴侣应用必须具有以下格式的Bundle ID才能与iOS应用通信：YOUR_IOS_BUNDLE_ID.watchkitapp。

如何使用

初始化

首先，导入库并创建FlutterWatchOsConnectivity的新实例：

import 'package:flutter_watch_os_connectivity/flutter_watch_os_connectivity.dart';

FlutterWatchOsConnectivity _flutterWatchOsConnectivity = FlutterWatchOsConnectivity();

配置和激活会话

在发送或接收消息之前，需要调用configureAndActivateSession()方法来配置并激活会话：

_flutterWatchOsConnectivity.configureAndActivateSession();

获取当前的激活状态：

ActivationState _currentState = await _flutterWatchOsConnectivity.getActivateState();
if (_currentState == ActivationState.activated) {
    // 继续使用插件
} else {
    // 处理未激活的情况
}

监听激活状态变化：

_flutterWatchOsConnectivity.activationStateChanged.listen((activationState) {
    if (activationState == ActivationState.activated) {
        // 继续使用插件
    } else {
        // 处理未激活的情况
    }
});

获取配对设备信息及可达性

获取当前配对设备的信息：

WatchOsPairedDeviceInfo _pairedDeviceInfo = await _flutterWatchOsConnectivity.getPairedDeviceInfo();

监听配对设备信息的变化：

_flutterWatchOsConnectivity.pairedDeviceInfoChanged.listen((info) {
    _pairedDeviceInfo = info;
});

检查设备的可达性：

bool _isReachable = await _flutterWatchOsConnectivity.getReachability();

监听设备可达性的变化：

_flutterWatchOsConnectivity.reachabilityChanged.listen((isReachable) {
    _isReachable = isReachable;
});

发送和处理消息

发送消息到WatchOS应用：

await _flutterWatchOsConnectivity.sendMessage({
    "message": "This is a message sent from IOS app at ${DateTime.now().millisecondsSinceEpoch}"
});

发送带有回复的消息：

_flutterWatchOsConnectivity.sendMessage({
    "message": "This is a message sent from IOS app with reply handler at ${DateTime.now().millisecondsSinceEpoch}"
}, replyHandler: ((message) async {
    // 收到WatchOS的回复后触发此回调
    _currentRepliedMessage = message;
}));

监听从WatchOS应用收到的消息：

_flutterWatchOsConnectivity.messageReceived.listen((message) async {    
    /// 新消息被接收，可以从data map中读取内容
    _currentMessage = message.data;
});

如果收到的消息包含replyMessage属性且不为null，则应回复此消息：

_flutterWatchOsConnectivity.messageReceived.listen((message) async {    
    _currentMessage = message.data;
    
    if (message.onReply != null) {
        try {
            await message.replyMessage!({
                "message": "Message received on IOS app at ${DateTime.now().millisecondsSinceEpoch}"
            });
        } catch (e) {
            print(e);
        }
    }
});

示例项目

更多详细信息，请参考我的Flutter示例项目和WatchOS示例项目。

通过上述步骤，您可以在Flutter应用中集成并使用flutter_watch_os_connectivity插件来实现与Apple Watch的通信。请根据您的具体需求选择合适的功能进行开发。


更多关于Flutter苹果手表连接性检测插件flutter_watch_os_connectivity的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

Harmonyos Next教程
1 回复

更多关于Flutter苹果手表连接性检测插件flutter_watch_os_connectivity的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


当然，下面是一个关于如何使用 flutter_watch_os_connectivity 插件来检测 Flutter 应用在 Apple Watch 上的连接性的示例代码。这个插件可以帮助你检测 Apple Watch 是否连接到 iPhone，以及当前的网络状态。

首先，你需要确保在 Flutter 项目中正确添加了 flutter_watch_os_connectivity 插件。你可以在 pubspec.yaml 文件中添加以下依赖：

dependencies:
  flutter:
    sdk: flutter
  flutter_watch_os_connectivity: ^最新版本号  # 请替换为实际可用的最新版本号

然后运行 flutter pub get 来安装依赖。

接下来，你需要配置你的 Flutter 项目以支持 Apple Watch。这通常涉及到创建一个 WatchKit 扩展和 WatchOS 应用。假设你已经完成了这些步骤，现在可以在你的 Flutter 项目中使用 flutter_watch_os_connectivity 插件了。

以下是一个示例代码，展示如何在 Flutter 应用中检测 Apple Watch 的连接性：

1. 导入插件

在你的 Dart 文件中导入插件：

import 'package:flutter_watch_os_connectivity/flutter_watch_os_connectivity.dart';

2. 检测连接性

你可以使用插件提供的 API 来检测 Apple Watch 是否连接到 iPhone，以及网络状态。以下是一个简单的示例：

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: ConnectivityScreen(),
    );
  }
}

class ConnectivityScreen extends StatefulWidget {
  @override
  _ConnectivityScreenState createState() => _ConnectivityScreenState();
}

class _ConnectivityScreenState extends State<ConnectivityScreen> {
  bool _isConnectedToPhone = false;
  String _networkStatus = 'Unknown';

  @override
  void initState() {
    super.initState();
    _checkConnectivity();
    // 监听连接性变化
    FlutterWatchOSConnectivity.connectivityStatusStream.listen((status) {
      setState(() {
        _isConnectedToPhone = status.isConnectedToPhone;
        _networkStatus = status.networkStatus.toString();
      });
    });
  }

  void _checkConnectivity() async {
    final connectivityStatus = await FlutterWatchOSConnectivity.checkConnectivityStatus();
    setState(() {
      _isConnectedToPhone = connectivityStatus.isConnectedToPhone;
      _networkStatus = connectivityStatus.networkStatus.toString();
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('WatchOS Connectivity Example'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text(
              'Connected to Phone: $_isConnectedToPhone',
              style: TextStyle(fontSize: 20),
            ),
            SizedBox(height: 20),
            Text(
              'Network Status: $_networkStatus',
              style: TextStyle(fontSize: 20),
            ),
          ],
        ),
      ),
    );
  }
}

3. 运行应用

确保你的 Flutter 项目已经正确配置为支持 WatchOS，并且你已经将 WatchKit 扩展和 WatchOS 应用添加到了项目中。然后，你可以使用 Flutter 工具链来运行你的应用：

flutter run

如果一切配置正确，你应该能够在你的 Apple Watch 上看到连接性状态和网络状态的显示。

这个示例展示了如何使用 flutter_watch_os_connectivity 插件来检测 Apple Watch 的连接性。你可以根据需要进一步扩展和自定义这个示例。

回到顶部