介绍
react-native-nearby-api-windows 是一个专为 Windows 平台下 React Native 应用开发的 npm 包。它提供了一套丰富的 API，让开发者能够方便地在 React Native 应用中使用 Windows Nearby API，从而实现设备之间的通信和数据共享。
该 npm 包的目标用户群体主要是 Windows 平台下的 React Native 开发人员，无论是初学者还是专业开发者，都能够在极短的时间内掌握该包的使用方法，快速实现应用中所需的功能。
安装
要使用 react-native-nearby-api-windows，你需要先安装 React Native 和 Node.js。你可以使用以下命令在 React Native 项目中安装该 npm 包：
npm install react-native-nearby-api-windows --save
安装完成后，还需要进行一些配置：
在 Windows 上配置项目
在 Windows 上，首先需要安装 Microsoft Visual C++ Redistributable for Visual Studio 2017。然后，你需要在你的项目的 AndroidManifest.xml 文件中添加以下权限：
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/>
该权限用于在设备之间建立连接时控制 Wi-Fi 状态。
在 iOS 上配置项目
在 iOS 上，你需要在项目中添加 NSBonjourServices 这一项 privacy 权限，它用于在设备之间共享数据。你可以在项目的 Info.plist 文件中添加以下代码：
<key>NSBonjourServices</key>
<array>
<string>_http._tcp.</string>
<string>_ftp._tcp.</string>
</array>使用教程
react-native-nearby-api-windows 的所有 API 都可以用于 React Native 应用。在使用每个 API 之前，你必须在你的代码中引用该包，如下所示：
import NearByAPI from 'react-native-nearby-api-windows';
接下来，让我们看一下一些常用的 API，以及它们的使用方法。
探测设备
要探测附近的设备，可以使用 NearByAPI.startDiscovery(discoveryListener) 方法，该方法将返回一个 Promise。你需要传入一个 discoveryListener 对象，用于在检测到设备时回调。以下是该方法的例子：
-- -------------------- ---- -------
----- ----------------- - -
-------- ------------ ----------------------- -- -
------------------- ------------
--
------- ------------ -- -
--------------------- ------------
--
--
-------------------------------------------
-------- -- ---------------------
-------------- -- --------------------建立连接
要在设备之间建立连接，可以使用 NearByAPI.requestConnection(name, endpointId, connectionListener) 方法，该方法将返回一个 Promise。你需要指定一个设备名称、一个 endpointId 并传入一个 connectionListener 对象，用于在连接建立、连接断开等状态变化时回调。以下是该方法的例子：
-- -------------------- ---- -------
----- ------------------ - -
---------------------- ------------ --------------- -- -
---------------------- ------------
--
------------------- ------------ ------- -- -
---------------------- --------
--
--------------- ------------ -- -
------------------- ------------
--
--
--------------------------------- ----------- -------------------
-------- -- ----------------------
-------------- -- --------------------发送数据
要在设备之间发送数据，可以使用 NearByAPI.sendPayload(endpointId, payload) 方法，该方法将返回一个 Promise。你需要指定一个 endpointId，并传入一个 payload 对象，用于携带发送数据。以下是该方法的例子：
const payload = {
text: 'hello world',
};
NearByAPI.sendPayload(endpointId, payload)
.then(() => console.log('已发送数据'))
.catch((error) => console.log(error));接收数据
要接收从其它设备发来的数据，可以使用 NearByAPI.receiveData(connectionListener) 方法。该方法将返回一个 Promise，并在接收到数据时触发回调。
-- -------------------- ---- -------
----- ------------------ - -
------------------ ------------ -------- -- -
------------------- ----------- ---------
--
--
-----------------------------------------
-------- -- -----------------------
-------------- -- --------------------总结
本文简要介绍了 npm 包 react-native-nearby-api-windows 的使用方法，其中包括探测设备、建立连接、发送数据、接收数据等常用 API。通过本文的学习，相信读者能够快速上手使用该 npm 包，并成功实现设备之间的通信和数据共享。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60065b48c6eb7e50355dbf79