本文共 3129 字，大约阅读时间需要 10 分钟。

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发现周围玩家，同时也会被周围玩家发现。调用接口代码如下：

void Start() {    AndroidMyCallback cb = new AndroidMyCallback(this);    nm  = new  NearbyManager(cb);    nm.startDiscovery(randomName());}

• 回调函数AndroidMyCallback用于定义发现成功之后需要做的动作。

// 在发现一名玩家之后，如何处理。在本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);}

• 发现附近玩家成功之后，可以向玩家发送组队邀请/好友邀请/道具分享等消息。

// 在本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()。在实际游戏场景中，在两个游戏设备中分别调用这两个接口便可以完成组网。

• 调用接口代码示例

private void OnClick() {    Button btn = this.GetComponent();    btn.enabled = false;    AndroidMyCallback androidMyCallback = new AndroidMyCallback(mNetworkManager);    NearbyManager nearbyManager = new NearbyManager(androidMyCallback);    nearbyManager.startBroadcast();}

• 回调函数AndroidMyCallback用于组网成功之后需要做哪些动作，本例中在发现之后调用UNET的networkManager接口开始游戏

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

• UNET-NEARBY-DEMO

四、其他集成Nearby Service的游戏应用

• Tic Tac Toe

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

• NearbyGameSnake

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

五、更多详情

• 华为开发者联盟官网：

• 获取开发指导文档：

• 参与开发者讨论请到Reddit社区：

• 下载demo和示例代码请到Github：

• 解决集成问题请到Stack Overflow：

---

原文链接：

作者：timer

转载地址：http://rouuz.baihongyu.com/