Development Guide for Integrating the HUAWEI OneHop Kit 2 - Huawei Developers

HUAWEI OneHop is a core part of Huawei's device distributed technology. It augments traditional NFC technology with additional short-distance technologies to enable efficient collaboration between smartphones and other devices with a single tap. There are a few things that you should know when integrating HUAWEI OneHop Kit:
Steps for Developing Cross-device Shortcuts
You can trigger OneHop shortcuts by doing the following:
(1) Select the device type.
(2) Select a OneHop shortcut that is supported by the device.
(3) On the device, download and integrate the OneHop development package.
(4) Check that the NFC works properly.
(5) Test and complete the certification.
Steps for Integrating the HUAWEI OneHop Kit to Printers
The diagram below shows the full integration process.
{
"lightbox_close": "Close",
"lightbox_next": "Next",
"lightbox_previous": "Previous",
"lightbox_error": "The requested content cannot be loaded. Please try again later.",
"lightbox_start_slideshow": "Start slideshow",
"lightbox_stop_slideshow": "Stop slideshow",
"lightbox_full_screen": "Full screen",
"lightbox_thumbnails": "Thumbnails",
"lightbox_download": "Download",
"lightbox_share": "Share",
"lightbox_zoom": "Zoom",
"lightbox_new_window": "New window",
"lightbox_toggle_sidebar": "Toggle sidebar"
}
The app on the device invokes OneHop Kit to enable Wi-Fi P2P GO mode and write the Wi-Fi data into the NFC tag. During this step, the app on the printer needs to invoke the APIs to initialize and enable the OneHop service.
Users select the file they want to transfer from their phone, then tap the phone against the NFC tag on the device.
The phone obtains the Wi-Fi connection data and establishes a connection with the device.
The phone sends an image transfer notification to the OneHop Kit integrated on the device. The OneHop Kit receives the notification, then sends this notification to the app on the device to prompt the user to start transferring files.
The user accepts, and the phone sends the file to the device. The device then sends a notification to the app on the device to proceed to the next step. Once the app on the device has received the notification, it starts the printing process.
Note
To enable OneHop Kit to read and write NFC tags, the app on the device must have the corresponding driver APIs it needs to use OneHop. For details, refer to the documentation on driver_adapt.h in API Description.
There are two possible exceptions which may occur during the process. (1) The Wi-Fi-P2P connection disconnects unexpectedly during the transfer; (2) No action is taken within 60 seconds and the OneHop Kit sends a service termination value to the app on the device via a status modification callback to stop the OneHop service.
For details about API definitions, refer to the API Description.
Code Sample
This is how the OneHop demo program invokes APIs to initiate OneHop printing:
Note: For details about codes, refer to Sample Code for integrating OneHop for Linux devices. For details about API descriptions, refer to API for integrating OneHop for Linux devices
NFC Tag Handling and Data Parsing
NFC tag handling: App developers do not need to do this. NFC tags are programmed and attached by hardware vendors and distributed using hardware devices.
Data format parsing: App developers do not need to do this. The system automatically parses the OneHop data in the NFC tag and triggers the corresponding operation procedure.