Network Sharing

Overview

The Network Sharing module allows you to share your device’s Internet connection with other connected devices by means of Wi-Fi hotspot, Bluetooth, and USB sharing. It also allows you to query the network sharing state and shared mobile data volume.

NOTE To maximize the application running efficiency, most API calls are called asynchronously in callback or promise mode. The following code examples use the callback mode. For details about the APIs, see sms API Reference.

Basic Concepts

• Wi-Fi sharing: Shares the network through a Wi-Fi hotspot.
• Bluetooth sharing: Shares the network through Bluetooth.
• USB tethering: Shares the network using a USB flash drive.

Constraints

• Programming language: C++ and JS
• System: Linux kernel
• The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.

When to Use

Typical network sharing scenarios are as follows:

• Enabling Network Sharing
• Disabling network sharing
• Obtaining the data traffic of the shared network

The following describes the development procedure specific to each application scenario.

Available APIs

For the complete list of APIs and example code, see Network Sharing.

Enabling Network Sharing

1. Import the sharing namespace from @ohos.net.sharing.
2. Subscribe to network sharing state changes.
3. Call startSharing to start network sharing of the specified type.
4. Return the callback for successfully starting network sharing.

// Import the sharing namespace from @ohos.net.sharing.
import sharing from '@ohos.net.sharing';
import { BusinessError } from '@ohos.base';

// Subscribe to network sharing state changes.
sharing.on('sharingStateChange', (data: boolean) => {
  console.log(JSON.stringify(data));
});

// Call startSharing to start network sharing of the specified type.
sharing.startSharing(sharing.SharingIfaceType.SHARING_WIFI, (error: BusinessError) => {
  console.log(JSON.stringify(error));
});

Disabling network sharing

How to Develop

1. Import the sharing namespace from @ohos.net.sharing.
2. Subscribe to network sharing state changes.
3. Call stopSharing to stop network sharing of the specified type.
4. Return the callback for successfully stopping network sharing.

// Import the sharing namespace from @ohos.net.sharing.
import sharing from '@ohos.net.sharing';
import { BusinessError } from '@ohos.base';

// Subscribe to network sharing state changes.
sharing.on('sharingStateChange', (data: boolean) => {
  console.log(JSON.stringify(data));
});

// Call stopSharing to stop network sharing of the specified type.
sharing.stopSharing(sharing.SharingIfaceType.SHARING_WIFI, (error: BusinessError) => {
  console.log(JSON.stringify(error));
});

Obtaining the data traffic of the shared network

How to Develop

1. Import the sharing namespace from @ohos.net.sharing.
2. Call startSharing to start network sharing of the specified type.
3. Call getStatsTotalBytes to obtain the data traffic generated during data sharing.
4. Call stopSharing to stop network sharing of the specified type and clear the data volume of network sharing.

// Import the sharing namespace from @ohos.net.sharing.
import sharing from '@ohos.net.sharing';
import { BusinessError } from '@ohos.base';

// Call startSharing to start network sharing of the specified type.
sharing.startSharing(sharing.SharingIfaceType.SHARING_WIFI, (error: BusinessError) => {
  console.log(JSON.stringify(error));
});

// Call getStatsTotalBytes to obtain the data traffic generated during data sharing.
sharing.getStatsTotalBytes((error: BusinessError, data: number) => {
  console.log(JSON.stringify(error));
  console.log(JSON.stringify(data));
});

// Call stopSharing to stop network sharing of the specified type and clear the data volume of network sharing.
sharing.stopSharing(sharing.SharingIfaceType.SHARING_WIFI, (error: BusinessError) => {
  console.log(JSON.stringify(error));
});

// Call getStatsTotalBytes again. The data volume of network sharing has been cleared.
sharing.getStatsTotalBytes((error: BusinessError, data: number) => {
  console.log(JSON.stringify(error));
  console.log(JSON.stringify(data));
});

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Connectivity

harmony 鸿蒙HTTP Data Request

harmony 鸿蒙IPC & RPC Development Guidelines

harmony 鸿蒙IPC & RPC Overview

harmony 鸿蒙Network Connection Management

harmony 鸿蒙Ethernet Connection

harmony 鸿蒙mDNS Management

harmony 鸿蒙Network Management Overview

harmony 鸿蒙Traffic Management

harmony 鸿蒙VPN Management