HMS Nearby Service是HMS Core的一个重要特性，基于Wi-Fi/蓝牙底层技术，帮助游戏玩家快速发现周边的人，并在设备间自动建立低延时、高可靠、零流量的数据传输通道，提升游戏体验。

## 一、Nearby Service可以在以下方面为您的游戏提供更好的体验

#### 1、一键联机

现有的本地联机方案需要用户接入同一个路由器，若无路由器则需用户手动建立热点，操作繁琐。Nearby Service可以实现一键本地联机而无需借助路由器。

#### 2、面对面组队/加好友

Nearby Service可以帮助您实现面对面组队/加好友，无需依赖社交软件，无需GPS，让玩家便捷的与身边的朋友一起“开黑”。

#### 3、面对面道具分享

Nearby Service可以帮助您的游戏快速实现面对面道具分享，让玩家便捷的分享游戏道具给现实的朋友，这可以帮助您的游戏拉新促活，增加用户粘性。

## 二、插件介绍

这里为大家带来两个已经封装好的插件，您可以在应用中直接使用这两个插件；也可以查看插件源码了解如何集成Nearby Service。

#### 1、开发准备

- Unity开发环境

- 下载插件:GitHub

#### 2、导入插件

- 在Unity工具菜单上依次打开"Assets"--> "Import Package" --> "Custom Package"，选择插件:Nearby Player/Discovery Plugin

- 等待对包的处理，完成后会列出插件中的资源列表，点击"Import"

#### 3、关键代码介绍

**3.1、Nearby Player Plugin**

Nearby Player Plugin适用于面对面组队/加好友/分享等场景。插件中声明NearbyManager类，该类提供两个方法startDiscovery()和SendMessage()用于发现周边的玩家和发送消息。

- 在程序启动时调用startDiscovery发现周围玩家，同时也会被周围玩家发现。调用接口代码如下：

```java
void Start() {
    AndroidMyCallback cb = new AndroidMyCallback(this);
    nm  = new  NearbyManager(cb);
    nm.startDiscovery(randomName());
}
```
- 回调函数AndroidMyCallback用于定义发现成功之后需要做的动作。

```java
// 在发现一名玩家之后，如何处理。在本demo中我们将其添加到玩家列表
public override void onFoundPlayer(string endpointName, string endpointId) {
    mListController.AddPlayerToList(endpointName, endpointId);
}
  
// 在丢失一名玩家后，如何处理。在本demo中我们将其移除玩家列表
public override void onLostPlayer(string endpointId) {
    mListController.RemovePlayerFromList(endpointId);
}
  
// 在收到玩家消息时，如何处理。在本demo中我们只展示消息内容
public override void onReceiveMsg(string endpointName, string Msg) {
    mListController.ReceiveMsg(endpointName, Msg);
}
```
- 发现附近玩家成功之后，可以向玩家发送组队邀请/好友邀请/道具分享等消息。

```java
// 在本demo中，我们点击玩家列表中的某位玩家，即向其发送组队邀请消息
private void OnClick(string endpointId) {
    nm.log("OnClick. SendMessage to " + endpointId);
    nm.SendMessage(endpointId, "invites you to join a game.");
}
```
**3.2、Nearby Discovery Plugin**
Nearby Discovery Plugin基于Unity UNET组件开发的插件，使用该插件可以不需要用户连接同一个Wi-Fi即可完成组网。插件中声明NearbyManager类，该类提供了两个方法startBroadcast()和startDiscovery()。在实际游戏场景中，在两个游戏设备中分别调用这两个接口便可以完成组网。

- 调用接口代码示例

```java
private void OnClick() {
    Button btn = this.GetComponent<Button>();
    btn.enabled = false;
    AndroidMyCallback androidMyCallback = new AndroidMyCallback(mNetworkManager);
    NearbyManager nearbyManager = new NearbyManager(androidMyCallback);
    nearbyManager.startBroadcast();
}
```
- 回调函数AndroidMyCallback用于组网成功之后需要做哪些动作，本例中在发现之后调用UNET的networkManager接口开始游戏

```java
public class AndroidMyCallback : AndroidCallback {
    private NetworkManager mNetworkManager;
  
    public AndroidMyCallback(NetworkManager networkManager) : base()  {
        mNetworkManager = networkManager;
    }
     
    public override void onClientReady(string ipaddr) {
        mNetworkManager.networkAddress = ipaddr;
        mNetworkManager.StartClient();
    }
  
    public override void onServerReady(string ipaddr) {
        mNetworkManager.StartHost();
    }
}
```
#### 4、示例应用
为便于您更好的了解如何使用插件，这里为您带来两个集成了上述插件的示例应用以便您参考。

- Nearby-Player-Demo
![在这里插入图片描述](https://img-blog.csdnimg.cn/2020111614063932.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

- UNET-NEARBY-DEMO
![在这里插入图片描述](https://img-blog.csdnimg.cn/202011161406472.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

## 四、其他集成Nearby Service的游戏应用
- **Tic Tac Toe**

Tic Tac Toe是一款基于Nearby原生安卓接口开发的本地联机对战游戏，集成Nearby Service之后可以实现无网络场景下的联机游戏，目前已上架华为应用市场。

- **NearbyGameSnake**

NearbyGameSnake是一款集成了Nearby Service的多人联机游戏，操作界面简单，玩家无需配置网络，一键即可加入游戏。

## 五、更多详情

- 华为开发者联盟官网：
     [https://developer.huawei.com/consumer/en/hms/huawei-nearbyservice?ha_source=hms1](https://developer.huawei.com/consumer/en/hms/huawei-nearbyservice?ha_source=hms1)

- 获取开发指导文档：
     [https://developer.huawei.com/consumer/en/doc/development/HMSCore-Guides-V5/introduction-0000001050040566-V5?ha_source=hms1](https://developer.huawei.com/consumer/en/doc/development/HMSCore-Guides-V5/introduction-0000001050040566-V5?ha_source=hms1)

- 参与开发者讨论请到Reddit社区：[https://www.reddit.com/r/HuaweiDevelopers/](https://www.reddit.com/r/HuaweiDevelopers/)

- 下载demo和示例代码请到Github：[https://github.com/HMS-Core](https://github.com/HMS-Core)

- 解决集成问题请到Stack Overflow：
     [https://stackoverflow.com/questions/tagged/huawei-mobile-services?tab=Newest](https://stackoverflow.com/questions/tagged/huawei-mobile-services?tab=Newest)

---
原文链接：
[https://developer.huawei.com/consumer/cn/forum/topic/0201395195892590034?fid=18](https://developer.huawei.com/consumer/cn/forum/topic/0201395195892590034?fid=18)
作者：timer

ITPub博客

教您如何集成Nearby Service提升游戏体验，减少开发难度

最新文章