https://editor.csdn.net/md/?articleId=109243638

Huawei's Near Field Service (Nearby Service) uses Huawei's self-developed protocol. After the application is integrated with the Near Service, it can realize fast and fast file transfer between smart devices without traffic, and the integration process is simple and easy to understand.

With the increasing penetration rate of smart phones, people are becoming more and more dependent on smart phones. Most commonly used mobile phone applications have file transfer functions, such as: social applications (transfer pictures, files, chat history, etc.), file management applications (transfer files, backup, phone cloning, etc.), audio and video applications (share songs) , Video, etc.). The file transfer function of these types of applications is mainly to transfer files to another device with the help of network disks and cloud servers. These methods all need to use user traffic or need to be transmitted in a Wi-Fi scenario, and do not have the capability of face-to-face transmission without traffic. Some developers may try to achieve near-field data transmission through Bluetooth or Wi-Fi, but this requires dealing with complex network protocols and hardware devices, and the transmission speed is not satisfactory.

Four advantages of Nearby Service

Easy integration : Only 2 file transfer APIs, no need to deal with complex network protocols.
Extremely fast transmission : The maximum transmission rate can exceed 60M/sec, and the transfer of 1GB files only takes 20 seconds.
No need to connect to the Internet : Without the help of routers or other network devices, data transmission is realized through Bluetooth and Wi-Fi, and it does not cost users their own traffic.
Platform support : Supports all Android platforms (Huawei devices and non-Huawei devices), and other platforms will be opened one after another.

Demo application introduction (NearbyTransfer)

In order to let developers better understand how to integrate Nearby Service, here is a demo for scanning code to transfer files for reference. NearbyTransfer integrates #HMS Core# Nearby Service and Scan Kit, and can complete data transmission between two smart devices (mobile phones, Pads, etc.) by scanning codes.

Development combat

Github link of NearbyTransfer open source project:

https://github.com/HMS-Core/hms-nearby-demo/tree/master/NearbySimpleconnection

Here is how to run this Demo based on the source code, so that you can understand the implementation details.

Development preparation

Tool preparation

Two Huawei phones (best effect)
Development Tools Android Studio (3.X or later)

Register as a developer

Create an application

Refer to the development of Nearby Service and prepare to create your application in the Huawei application market.

Build a demo application

Import source code to Android Studio (3.X or later)

Download the agconnect-services.json file of the newly created application on the Huawei App Market to the local, and place it in the app directory (\app) of the sample code.

Run the sample application

Install Demo application to test machine A, B
Select "Send File" on test machine A, select the file to be transferred, and generate a QR code
Select "Receive File" on test machine B
Wait for the file transfer to end

Insert picture description here

Key code description

Add Huawei maven warehouse in project-level gradle

AndroidStudio project-level build.gradle file, incrementally add the following maven address:

buildscript {
    repositories {
        maven { url 'http://developer.huawei.com/repo/'}
    }    }allprojects {
    repositories {
        maven { url 'http://developer.huawei.com/repo/'}
    }}

Add SDK dependencies to application-level build.gradle

dependencies {
    implementation 'com.huawei.hms:nearby:5.0.2.300'
    implementation 'com.huawei.hms:scan:1.2.3.300'
}

Declare system permissions in the AndroidManifest.xml file

Because Nearby Service is based on Bluetooth, Wi-Fi, storage and other capabilities, it is necessary to declare the permissions of Bluetooth, Wi-Fi, storage, and location information. (To be added scan code permissions)

    <uses-permission android:name="android.permission.BLUETOOTH" />
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
    <!--相机权限-->
    <uses-permission android:name="android.permission.CAMERA" />

Because ACCESS_FINE_LOCATION, WRITE_EXTERNAL_STORAGE and READ_EXTERNAL_STORAGE are dangerous system permissions, you need to apply for these permissions dynamically. If the permissions are insufficient, Nearby Service will refuse to enable broadcasting or scanning for your application.

Key code

Main code path: com\huawei\hms\simpleNearbyDemo\MainActivity.java

If your application needs to integrate Nearby Service to transfer files, you only need to refer to MainActivity to integrate nearbyAgent.sendFile() and nearbyAgent.receiveFile() into your application, then you can scan code to transfer files.

1. Send the file The
sender selects the file and calls nearbyAgent.sendFile(uri) to prepare to send the file

@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
    switch (requestCode) {
        case FILE_SELECT_CODE:
            if (resultCode == RESULT_OK) {
                // Get the Uri of the selected file
                Uri uri = data.getData();
                nearbyAgent.sendFile(uri);
            }
            break;
        case NearbyAgent.REQUEST_CODE_SCAN_ONE:
            nearbyAgent.onScanResult(data);
        default:
            break;
    }

    super.onActivityResult(requestCode, resultCode, data);
}

2. The recipient of the received file
calls nearbyAgent.onScanResult(data) to receive the file

  recvBtn.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            nearbyAgent.receiveFile();
        }
    });

For more details, please refer to:

Official website of Huawei Developer Alliance:https://developer.huawei.com/consumer/en/hms/huawei-pushkit

Obtain development guidance documents:https://developer.huawei.com/consumer/en/doc/development/HMSCore-Guides/service-introduction-0000001050040060

To participate in developer discussions, please go to the Reddit community:https://www.reddit.com/r/HuaweiDevelopers/

To download the demo and sample code, please go to Github:https://github.com/HMS-Core

To solve integration problems, please go to Stack Overflow:https://stackoverflow.com/questions/tagged/huawei-mobile-services?tab=Newest

Original link: https://developer.huawei.com/consumer/cn/forum/topicview?tid=0203382449995050417&fid=18
Author: pepper