nativescript-watchos-connector

这是一个使用 Apple WatchConnectivity 传递和接收数据的 NativeScript 插件，用于与配套的 WatchOS 应用程序。

先决条件 / 需求

在开始使用此插件之前，请确保您已阅读了 NativeScript 博客上关于为您的 NativeScript 应用程序开发 watchOS 扩展和 iOS WatchOS 应用程序的文章。

安装 NativeScript 7

npm i nativescript-watchos-connector

在 NativeScript 7 之前安装

npm i nativescript-watchos-connector@1.0.11

用法

NativeScript Angular

要使此插件正常工作，您必须首先在 app.module.ts 中将 nativescript-watchos-connector 添加为提供者。

Typescript

import  {  WatchOSConnector  }  from  'nativescript-watchos-connector'

@NgModule({
	bootstrap: [AppComponent],
	imports: [],
	providers: [ WatchOSConnector ],
	declarations: [ AppComponent ],
	schemas: [ NO_ERRORS_SCHEMA ]
})

导入 nativescript-watchos-connector 插件

Typescript

import  {  WatchOSConnector  }  from  'nativescript-watchos-connector'

在构造函数中创建导入的实例

Typescript

constructor(
	private _watchOSConnector: WatchOSConnector
) {}

插件概述

这是当前所有可用函数及其在此插件中使用方法的简要说明。

函数	描述
`createWCSession()`	创建 WCSession
`watchOSChecker()`	检查用户是否在 iOS 上，是否有配对的 Apple Watch 以及 WatchOS 应用程序已安装
`checkActivation()`	检查 WCSession 是否处于活动状态（如果不是，将激活会话）
`convertInt(value)`	将值作为 Obj-C int 返回
`convertDouble(value)`	将值作为 Obj-C double 返回
`convertFloat(value)`	将值作为 Obj-C float 返回
`sendObjectToWatch('objectKey', object)`	使用 ApplicationContext 将数据发送到配套的 WatchOS 应用程序

createWCSession()

createWCSession 检查设备是否支持 WCSession，如果是，将创建 WCSession。

Typescript

this.watchOSConnector.createWCSession()

watchOSChecker()

当与 Apple Watch 传递数据一起工作时，使用 watchOSChecker 而不是 isIOS。此检查用户是否在 iOS 上，是否有配对的 Apple Watch 以及 WatchOS 应用程序已安装（返回布尔值）

Typescript

if (this.watchOSConnector.watchOSChecker()) {
// Only run if WatchOS app is avalaible
}

checkActivation()

检查 WCSession 是否处于活动状态，如果不是，将激活当前会话。在 sendObject 中调用此函数以确保有活动会话。

Typescript

this.watchOSConnector.checkActivation()

convertInt(value)

将值作为 int 的 NSNumber 返回

Typescript

this.watchOSConnector.convertInt(2319)

convertDouble(value)

将值作为 double 的 NSNumber 返回

Typescript

this.watchOSConnector.convertDouble(42.957194)

convertFloat(value)

将值作为 float 的 NSNumber 返回

Typescript

this.watchOSConnector.convertFloat(882.152)

sendObjectToWatch(objectKey, object)

使用 updateApplicationContext 将数据发送到配套的 WatchOS 应用程序。您需要传递对象的键和一个包含 Objective-C 有效的 值的对象。

Typescript

let intValue =  this.watchOSConnector.convertInt(4)
let doubleValue =  this.watchOSConnector.convertDouble(45.1)

let numberObject =  {
	convertedInt: intValue,
	convertedDouble: doubleValue
}

this.watchOSConnector.sendObject('numberObjectKey', numberObject)

v2.0.0 发布

更新为与 NativeScript 7 兼容

未来发布

[ ] 在 README 中添加图片
[ ] 创建一个演示应用程序

贡献者

DanHef - https://github.com/DanHef

许可

Apache 许可证版本 2.0，2004 年 1 月