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<Button>();
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的多人联机游戏，操作界面简单，玩家无需配置网络，一键即可加入游戏。
五、更多详情
-
华为开发者联盟官网：
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 -
参与开发者讨论请到Reddit社区：https://www.reddit.com/r/HuaweiDevelopers/
-
下载demo和示例代码请到Github：https://github.com/HMS-Core
- 解决集成问题请到Stack Overflow：
https://stackoverflow.com/questions/tagged/huawei-mobile-services?tab=Newest
原文链接：
https://developer.huawei.com/consumer/cn/forum/topic/0201395195892590034?fid=18
作者：timer