如何用HMS Nearby Service给自己的APP开发一个名片交换功能?

2023-10-30 01:10

本文主要是介绍如何用HMS Nearby Service给自己的APP开发一个名片交换功能?,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

  在工作和生活中,遇见新的同事或者合作伙伴,交换名片是一个常见的用户需求,纸质名片常忘带、易丢失,是客户的一个痛点。因此,市场上出现了很多交换电子名片的APP和小程序。那么,如何给自己的APP开发一个名片交换功能呢?

在这里插入图片描述

  我们可以接入华为近距离通信服务,通过近距离设备间消息订阅(Nearby Message),快速实现一对一或一对多名片交换。下图是功能演示:

在这里插入图片描述

  如果你对实现方式感兴趣,可以去Github去下载源代码,大家可以基于具体的应用场景优化。

  Github demo下载地址:https://github.com/HMS-Core/hms-nearby-demo/tree/master/NearbyCardExchange

开发具体步骤如下:

1. 开发准备

  如果您已经是华为的开发者,可以省略此步骤。如果您以前没有集成华为移动服务的经验,那么需要先配置AppGallery Connect,开通近距离通信服务并集成HMS SDK。相关步骤请参考官方文档。

2. 添加权限

  在使用Nearby Message之前,需要添加网络权限、蓝牙权限、位置权限。在工程的AndroidManifest.xml文件中添加如下权限:

<uses-permission android:name="android.permission.INTERNET " /><uses-permission android:name="android.permission.BLUETOOTH" /><uses-permission android:name="android.permission.BLUETOOTH_ADMIN" /><!-- The location permission is also required in Android 6.0 or later. --><uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /><uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

3. 代码开发

3.1 动态权限申请

  检查蓝牙开关、位置开关是否打开、网络是否可用,并对位置权限进行动态权限申请

@Overridepublic void onStart() {super.onStart();getActivity().getApplication().registerActivityLifecycleCallbacks(this);checkPermission();}@Overridepublic void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {for (int i = 0; i < permissions.length; ++i) {if (grantResults[i] != 0) {showWarnDialog(Constants.LOCATION_ERROR);}}}private void checkPermission() {if (!BluetoothCheckUtil.isBlueEnabled()) {showWarnDialog(Constants.BLUETOOTH_ERROR);return;}if (!LocationCheckUtil.isLocationEnabled(this.getActivity())) {showWarnDialog(Constants.LOCATION_SWITCH_ERROR);return;}if (!NetCheckUtil.isNetworkAvailable(this.getActivity())) {showWarnDialog(Constants.NETWORK_ERROR);return;}String[] deniedPermission = PermissionUtil.getDeniedPermissions(this.getActivity(), new String[] {Manifest.permission.ACCESS_COARSE_LOCATION,Manifest.permission.ACCESS_FINE_LOCATION});if (deniedPermission.length > 0) {PermissionUtil.requestPermissions(this.getActivity(), deniedPermission, 10);}}

3.2 封装名片发布接口和名片订阅接口

  订阅到的名片消息(onFound),把名片添加到查找名片对话框中显示;名片消息丢失时(onLost),从查找名片对话框中删除该名片

private MessageHandler mMessageHandler = new MessageHandler() {@Overridepublic void onFound(Message message) {CardInfo cardInfo = JsonUtils.json2Object(new String(message.getContent(), Charset.forName("UTF-8")),CardInfo.class);if (cardInfo == null) {return;}mSearchCardDialogFragment.addCardInfo(cardInfo);}@Overridepublic void onLost(Message message) {CardInfo cardInfo = JsonUtils.json2Object(new String(message.getContent(), Charset.forName("UTF-8")),CardInfo.class);if (cardInfo == null) {return;}mSearchCardDialogFragment.removeCardInfo(cardInfo);}};private void publish(String namespace, String type, int ttlSeconds, OnCompleteListener<Void> listener) {Message message = new Message(JsonUtils.object2Json(mCardInfo).getBytes(Charset.forName("UTF-8")), type,namespace);Policy policy = new Policy.Builder().setTtlSeconds(ttlSeconds).build();PutOption option = new PutOption.Builder().setPolicy(policy).build();Nearby.getMessageEngine(getActivity()).put(message, option).addOnCompleteListener(listener);}private void subscribe(String namespace, String type, int ttlSeconds, OnCompleteListener<Void> listener,GetCallback callback) {Policy policy = new Policy.Builder().setTtlSeconds(ttlSeconds).build();MessagePicker picker = new MessagePicker.Builder().includeNamespaceType(namespace, type).build();GetOption.Builder builder = new GetOption.Builder().setPolicy(policy).setPicker(picker);if (callback != null) {builder.setCallback(callback);}Nearby.getMessageEngine(getActivity()).get(mMessageHandler, builder.build()).addOnCompleteListener(listener);}

3.3 名片交换菜单处理

  面对面交换名片交换码,发布个人名片成功后,订阅名片消息

private boolean onExchangeItemSelected() {PinCodeDialogFragment dialogFragment = new PinCodeDialogFragment(passwrod -> {MyCardFragment.this.publish(passwrod, passwrod, Policy.POLICY_TTL_SECONDS_MAX, result -> {if (!result.isSuccessful()) {String str = "Exchange card fail, because publish my card fail. exception: "+ result.getException().getMessage();Log.e(TAG, str);Toast.makeText(getActivity(), str, Toast.LENGTH_LONG).show();return;}MyCardFragment.this.subscribe(passwrod, passwrod, Policy.POLICY_TTL_SECONDS_INFINITE, ret -> {if (!ret.isSuccessful()) {MyCardFragment.this.unpublish(passwrod, passwrod, task -> {String str = "Exchange card fail, because subscribe is fail, exception("+ ret.getException().getMessage() + ")";if (!task.isSuccessful()) {str = str + " and unpublish fail, exception(" + task.getException().getMessage()+ ")";}Log.e(TAG, str);Toast.makeText(getActivity(), str, Toast.LENGTH_LONG).show();});return;}mSearchCardDialogFragment.setOnCloseListener(() -> {MyCardFragment.this.unpublish(passwrod, passwrod, task -> {if (!task.isSuccessful()) {Toast.makeText(getActivity(), "Unpublish my card fail, exception: "+ task.getException().getMessage(), Toast.LENGTH_LONG).show();}});MyCardFragment.this.unsubscribe(task -> {if (!task.isSuccessful()) {Toast.makeText(getActivity(), "Unsubscribe fail, exception: "+ task.getException().getMessage(), Toast.LENGTH_LONG).show();}});});mSearchCardDialogFragment.show(getParentFragmentManager(), "Search Card");}, null);});});dialogFragment.show(getParentFragmentManager(), "pin code");return true;}

3.4 收藏名片处理

  收藏名片时把名片加入收藏列表,名片取消收藏时把名片从参数列表中删除,并把数据保存到本地存储中。

@Overridepublic void onFavorite(CardInfo cardInfo, boolean isFavorite) {if (isFavorite) {mFavoriteMap.put(cardInfo.getId(), cardInfo);} else {mFavoriteMap.remove(cardInfo.getId());}Set<String> set = new HashSet<>(mFavoriteMap.size());for (CardInfo card : mFavoriteMap.values()) {set.add(JsonUtils.object2Json(card));}SharedPreferences sharedPreferences = getContext().getSharedPreferences("data", Context.MODE_PRIVATE);sharedPreferences.edit().putStringSet(Constants.MY_FAVORITES_KEY, set).apply();}

4.结后语

  本次给大家演示的demo用到了华为HMS Nearby service的近距离设备间消息订阅功能。基于Nearby Message能力不仅仅可以用来做面对面交换名片,还可以帮助开发者实现很多有趣的功能,例如:

  1. 竞技类手游中的面对面组队功能
  2. 棋牌类手游中的面对面约局功能
  3. 近场AA收款功能
  4. 音乐曲目共享功能

更详细的开发指南参考华为开发者联盟官网:https://developer.huawei.com/consumer/cn/doc/development/HMS-Guides/nearby-service-introduction


往期链接:教你如何开发一个完败Miracast的投屏新功能
原文链接:https://developer.huawei.com/consumer/cn/forum/topicview?tid=0201276303118820181&fid=18
原作者:赵照

这篇关于如何用HMS Nearby Service给自己的APP开发一个名片交换功能?的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/304622

相关文章

Go语言开发实现查询IP信息的MCP服务器

《Go语言开发实现查询IP信息的MCP服务器》随着MCP的快速普及和广泛应用,MCP服务器也层出不穷,本文将详细介绍如何在Go语言中使用go-mcp库来开发一个查询IP信息的MCP... 目录前言mcp-ip-geo 服务器目录结构说明查询 IP 信息功能实现工具实现工具管理查询单个 IP 信息工具的实现服

Python的time模块一些常用功能(各种与时间相关的函数)

《Python的time模块一些常用功能(各种与时间相关的函数)》Python的time模块提供了各种与时间相关的函数,包括获取当前时间、处理时间间隔、执行时间测量等,:本文主要介绍Python的... 目录1. 获取当前时间2. 时间格式化3. 延时执行4. 时间戳运算5. 计算代码执行时间6. 转换为指

Android实现两台手机屏幕共享和远程控制功能

《Android实现两台手机屏幕共享和远程控制功能》在远程协助、在线教学、技术支持等多种场景下,实时获得另一部移动设备的屏幕画面,并对其进行操作,具有极高的应用价值,本项目旨在实现两台Android手... 目录一、项目概述二、相关知识2.1 MediaProjection API2.2 Socket 网络

Redis消息队列实现异步秒杀功能

《Redis消息队列实现异步秒杀功能》在高并发场景下,为了提高秒杀业务的性能,可将部分工作交给Redis处理,并通过异步方式执行,Redis提供了多种数据结构来实现消息队列,总结三种,本文详细介绍Re... 目录1 Redis消息队列1.1 List 结构1.2 Pub/Sub 模式1.3 Stream 结

MySQL索引的优化之LIKE模糊查询功能实现

《MySQL索引的优化之LIKE模糊查询功能实现》:本文主要介绍MySQL索引的优化之LIKE模糊查询功能实现,本文通过示例代码给大家介绍的非常详细,感兴趣的朋友一起看看吧... 目录一、前缀匹配优化二、后缀匹配优化三、中间匹配优化四、覆盖索引优化五、减少查询范围六、避免通配符开头七、使用外部搜索引擎八、分

Android实现悬浮按钮功能

《Android实现悬浮按钮功能》在很多场景中,我们希望在应用或系统任意界面上都能看到一个小的“悬浮按钮”(FloatingButton),用来快速启动工具、展示未读信息或快捷操作,所以本文给大家介绍... 目录一、项目概述二、相关技术知识三、实现思路四、整合代码4.1 Java 代码(MainActivi

Vue3组件中getCurrentInstance()获取App实例,但是返回null的解决方案

《Vue3组件中getCurrentInstance()获取App实例,但是返回null的解决方案》:本文主要介绍Vue3组件中getCurrentInstance()获取App实例,但是返回nu... 目录vue3组件中getCurrentInstajavascriptnce()获取App实例,但是返回n

如何解决idea的Module:‘:app‘platform‘android-32‘not found.问题

《如何解决idea的Module:‘:app‘platform‘android-32‘notfound.问题》:本文主要介绍如何解决idea的Module:‘:app‘platform‘andr... 目录idea的Module:‘:app‘pwww.chinasem.cnlatform‘android-32

SpringBoot集成Milvus实现数据增删改查功能

《SpringBoot集成Milvus实现数据增删改查功能》milvus支持的语言比较多,支持python,Java,Go,node等开发语言,本文主要介绍如何使用Java语言,采用springboo... 目录1、Milvus基本概念2、添加maven依赖3、配置yml文件4、创建MilvusClient

使用Python开发一个带EPUB转换功能的Markdown编辑器

《使用Python开发一个带EPUB转换功能的Markdown编辑器》Markdown因其简单易用和强大的格式支持,成为了写作者、开发者及内容创作者的首选格式,本文将通过Python开发一个Markd... 目录应用概览代码结构与核心组件1. 初始化与布局 (__init__)2. 工具栏 (setup_t