程序包 ohos.bluetooth

类 DataListenSocket

java.lang.Object

ohos.bluetooth.DataListenSocket

public class DataListenSocket
extends Object

Listens to Bluetooth data transmission.

This class provides four methods for creating a Bluetooth socket:

• dataListenInsecureRfcomm(java.lang.String,java.util.UUID): creates an insecure RFCOMM Bluetooth server listening socket based on service records.
• dataListenRfcomm(java.lang.String,java.util.UUID): creates a secure RFCOMM Bluetooth server listening socket based on service records.
• buildInsecureRfcommDataSocket(ohos.bluetooth.BluetoothRemoteDevice,java.util.UUID):Creates an insecure RFCOMM Bluetooth client socket based on the service record.
• buildRfcommDataSocket(ohos.bluetooth.BluetoothRemoteDevice,java.util.UUID):Creates an secure RFCOMM Bluetooth client socket based on the service record.

从以下版本开始:

7

方法概要

限定符和类型	方法	说明
SppClientSocket	buildInsecureRfcommDataSocket(BluetoothRemoteDevice device, UUID uuid)	Creates an insecure RFCOMM Bluetooth client socket based on the service record.
SppClientSocket	buildRfcommDataSocket(BluetoothRemoteDevice device, UUID uuid)	Creates an secure RFCOMM Bluetooth client socket based on the service record.
SppServerSocket	dataListenInsecureRfcomm(String name, UUID uuid)	Creates an insecure RFCOMM Bluetooth server listening socket based on the service record.
SppServerSocket	dataListenRfcomm(String name, UUID uuid)	Creates a secure RFCOMM Bluetooth server listening socket based on the service record.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细资料

dataListenInsecureRfcomm

public SppServerSocket dataListenInsecureRfcomm(String name,
                                                UUID uuid)
                                         throws IOException

Creates an insecure RFCOMM Bluetooth server listening socket based on the service record.

This connection mode does not require link key authentication and may encounter man-in-the-middle attacks. For Bluetooth 2.1 devices, the link will be forcibly encrypted. For devices using earlier Bluetooth versions, the link will not be encrypted. If you need an encrypted communication channel, use dataListenRfcomm(java.lang.String, java.util.UUID).

Use SppServerSocket#accept to retrieve incoming connections from devices.

The system will assign an unused RFCOMM channel.

The system registers a Service Discovery Protocol (SDP) record with the local SDP server, records the service name, and automatically assigns a channel. Remote Bluetooth devices can use the same UUID to query the SDP server and identify the channel to connect to. This SDP record will be removed if the socket is disabled or the application exits unexpectedly.

参数:

name - Indicates the service name in the SDP record.

uuid - Indicates the UUID in the SDP record.

返回:

Returns an insecure RFCOMM SppServerSocket.

抛出:

IOException - Throws this exception if an error occurs, for example, Bluetooth is disabled or unavailable.

从以下版本开始:

7

dataListenRfcomm

public SppServerSocket dataListenRfcomm(String name,
                                        UUID uuid)
                                 throws IOException

Creates a secure RFCOMM Bluetooth server listening socket based on the service record.

A remote device connecting to this socket is authenticated and communication over this socket is encrypted.

Use SppServerSocket#accept to retrieve incoming connections from devices.

The system will assign an unused RFCOMM channel.

The system registers a Service Discovery Protocol (SDP) record with the local SDP server, records the service name, and automatically assigns a channel. Remote Bluetooth devices can use the same UUID to query the SDP server and identify the channel to connect to. This SDP record will be removed if the socket is disabled or the application exits unexpectedly.

参数:

name - Indicates the service name in the SDP record.

uuid - Indicates the UUID in the SDP record.

返回:

Returns a secure RFCOMM SppServerSocket.

抛出:

IOException - Throws this exception if an error occurs, for example, Bluetooth is disabled or unavailable.

从以下版本开始:

7

buildInsecureRfcommDataSocket

public SppClientSocket buildInsecureRfcommDataSocket(BluetoothRemoteDevice device,
                                                     UUID uuid)
                                              throws IOException

Creates an insecure RFCOMM Bluetooth client socket based on the service record.

This connection mode does not require link key authentication and may encounter man-in-the-middle attacks. For Bluetooth 2.1 devices, the link will be forcibly encrypted. For devices using earlier Bluetooth versions, the link will not be encrypted. If you need an encrypted communication channel, use buildRfcommDataSocket(ohos.bluetooth.BluetoothRemoteDevice, java.util.UUID).

Use SppClientSocket#connect to initiate the outgoing connection.

The system will assign an unused RFCOMM channel.

参数:

device - Indicates an bluetooth remote device.

uuid - Indicates the UUID in the SDP record.

返回:

Returns an insecure RFCOMM SppClientSocket.

抛出:

IOException - Throws this exception if an error occurs, for example, Bluetooth is disabled or unavailable.

从以下版本开始:

7

buildRfcommDataSocket

public SppClientSocket buildRfcommDataSocket(BluetoothRemoteDevice device,
                                             UUID uuid)
                                      throws IOException

Creates an secure RFCOMM Bluetooth client socket based on the service record.

The remote device will be authenticated and communication on this socket will be encrypted.

Use SppClientSocket#connect to initiate the outgoing connection.

The system will assign an unused RFCOMM channel.

参数:

device - Indicates an bluetooth remote device.

uuid - Indicates the UUID in the SDP record.

返回:

Returns an insecure RFCOMM SppClientSocket.

抛出:

IOException - Throws this exception if an error occurs, for example, Bluetooth is disabled or unavailable.

从以下版本开始:

7