WifiP2pController

java.lang.Object
- ohos.wifi.p2p.WifiP2pController

```
public final class WifiP2pController
extends Object
```
Provides methods for managing the Wi-Fi peer-to-peer (P2P) service.
The management operations include initializing the Wi-Fi P2P service, discovering peer services and devices, creating a P2P group, and connecting to a specified peer device.

从以下版本开始:

3

字段概要

字段
限定符和类型	字段	说明
`static int`	`DEVICE_INFO_REQUEST`	Indicates the request for the Wi-Fi P2P device information.
`static int`	`DEVICE_LIST_REQUEST`	Indicates the request for the list of Wi-Fi P2P devices.
`static int`	`GROUP_INFO_REQUEST`	Indicates the request for the Wi-Fi P2P group information.
`static int`	`NETWORK_INFO_REQUEST`	Indicates the request for the Wi-Fi P2P network information.

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法	说明
`void`	`cancelConnect(WifiP2pCallback callback)`	Cancels a P2P connection that has been initiated.
`void`	`connect(WifiP2pConfig wifiP2pConfig, WifiP2pCallback callback)`	Initiates a P2P connection to a device with the specified configuration.
`void`	`createGroup(WifiP2pConfig wifiP2pConfig, WifiP2pCallback callback)`	Creates a P2P group.
`void`	`discoverDevices(WifiP2pCallback callback)`	Discovers Wi-Fi P2P devices.
`static WifiP2pController`	`getInstance(Context context)`	Obtains a `WifiP2pController` instance.
`IRemoteObject`	`init(EventRunner eventRunner, WifiP2pCallback callback)`	Initializes the P2P controller and enables Wi-Fi P2P capabilities.
`void`	`removeGroup(WifiP2pCallback callback)`	Removes a P2P group.
`void`	`requestP2pInfo(int requestType, WifiP2pCallback callback)`	Requests P2P information.
`void`	`stopDeviceDiscovery(WifiP2pCallback callback)`	Stops discovering Wi-Fi P2P devices.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - DEVICE_INFO_REQUEST
```
public static final int DEVICE_INFO_REQUEST
```
    Indicates the request for the Wi-Fi P2P device information.
    Your application can use requestP2pInfo(int,ohos.wifi.p2p.WifiP2pCallback) to request the Wi-Fi P2P device information.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    常量字段值
  - DEVICE_LIST_REQUEST
```
public static final int DEVICE_LIST_REQUEST
```
    Indicates the request for the list of Wi-Fi P2P devices.
    Your application can use requestP2pInfo(int,ohos.wifi.p2p.WifiP2pCallback) to request the list of Wi-Fi P2P devices.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    常量字段值
  - GROUP_INFO_REQUEST
```
public static final int GROUP_INFO_REQUEST
```
    Indicates the request for the Wi-Fi P2P group information.
    Your application can use requestP2pInfo(int,ohos.wifi.p2p.WifiP2pCallback) to request the Wi-Fi P2P group information.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    常量字段值
  - NETWORK_INFO_REQUEST
```
public static final int NETWORK_INFO_REQUEST
```
    Indicates the request for the Wi-Fi P2P network information.
    Your application can use requestP2pInfo(int,ohos.wifi.p2p.WifiP2pCallback) to request the Wi-Fi P2P network information.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    常量字段值
- 方法详细资料
  - getInstance
```
public static WifiP2pController getInstance(Context context)
                                     throws IllegalArgumentException
```
    Obtains a WifiP2pController instance.
    WifiP2pController is a singleton class.
    
    参数:
    
    context - Indicates the application context of the caller.
    
    返回:
    
    Returns the WifiP2pController instance.
    
    抛出:
    
    IllegalArgumentException - if the caller is missing required context.
    
    从以下版本开始:
    
    3
  - init
```
public IRemoteObject init(EventRunner eventRunner,
                          WifiP2pCallback callback)
                   throws RemoteException
```
    Initializes the P2P controller and enables Wi-Fi P2P capabilities.
    This method is used to establish a communication channel between devices. Before calling other Wi-Fi P2P-related methods, you must call this method first. Otherwise, calling other methods will fail.
    
    参数:
    
    eventRunner - Indicates the event runner that receives callbacks.
    
    callback - Indicates the callback that is invoked to notify the P2P information.
    
    抛出:
    
    RemoteException - Throws this exception if the WifiP2pController object is initialized failed.
    
    从以下版本开始:
    
    3
  - discoverDevices
```
public void discoverDevices(WifiP2pCallback callback)
                     throws RemoteException
```
    Discovers Wi-Fi P2P devices.
    The discovery result is notified by the callback passed by your application.
    Before calling this method, ensure that the WifiP2pController object has been initialized using the init(ohos.eventhandler.EventRunner,ohos.wifi.p2p.WifiP2pCallback) method.
    
    参数:
    
    callback - Indicates the callback that is invoked to notify the discovery result.
    
    抛出:
    
    RemoteException - Throws this exception if the WifiP2pController object is not initialized.
    
    从以下版本开始:
    
    3
  - stopDeviceDiscovery
```
public void stopDeviceDiscovery(WifiP2pCallback callback)
                         throws RemoteException
```
    Stops discovering Wi-Fi P2P devices.
    The result of stopping the discovery is notified by the callback passed by your application.
    Before calling this method, ensure that the WifiP2pController object has been initialized using the init(ohos.eventhandler.EventRunner,ohos.wifi.p2p.WifiP2pCallback) method.
    
    参数:
    
    callback - Indicates the callback that is invoked to notify the result of stopping the discovery.
    
    抛出:
    
    RemoteException - Throws this exception if the WifiP2pController object is not initialized.
    
    从以下版本开始:
    
    3
  - createGroup
```
public void createGroup(WifiP2pConfig wifiP2pConfig,
                        WifiP2pCallback callback)
                 throws RemoteException
```
    Creates a P2P group.
    The P2P group creation result is notified by the callback passed by your application.
    Before calling this method, ensure that the WifiP2pController object has been initialized using the init(ohos.eventhandler.EventRunner,ohos.wifi.p2p.WifiP2pCallback) method.
    
    参数:
    
    wifiP2pConfig - Indicates the P2P configuration used to create the P2P group.
    
    callback - Indicates the callback that is invoked to notify the P2P group creation result.
    
    抛出:
    
    RemoteException - Throws this exception if the WifiP2pController object is not initialized.
    
    从以下版本开始:
    
    3
  - removeGroup
```
public void removeGroup(WifiP2pCallback callback)
                 throws RemoteException
```
    Removes a P2P group.
    The P2P group removal result is notified by the callback passed by your application.
    Before calling this method, ensure that the WifiP2pController object has been initialized using the init(ohos.eventhandler.EventRunner,ohos.wifi.p2p.WifiP2pCallback) method.
    
    参数:
    
    callback - Indicates the callback that is invoked to notify the P2P group removal result.
    
    抛出:
    
    RemoteException - Throws this exception if the WifiP2pController object is not initialized.
    
    从以下版本开始:
    
    3
  - requestP2pInfo
```
public void requestP2pInfo(int requestType,
                           WifiP2pCallback callback)
                    throws RemoteException
```
    Requests P2P information.
    The P2P information is notified by the callback passed by your application.
    Before calling this method, ensure that the WifiP2pController object has been initialized using the init(ohos.eventhandler.EventRunner,ohos.wifi.p2p.WifiP2pCallback) method.
    
    参数:
    
    requestType - Indicates the request type, which can be GROUP_INFO_REQUEST, DEVICE_INFO_REQUEST, NETWORK_INFO_REQUEST or DEVICE_LIST_REQUEST.
    
    callback - Indicates the callback that is invoked to notify the P2P information.
    
    抛出:
    
    RemoteException - Throws this exception if the WifiP2pController object is not initialized.
    
    从以下版本开始:
    
    3
  - connect
```
public void connect(WifiP2pConfig wifiP2pConfig,
                    WifiP2pCallback callback)
             throws RemoteException
```
    Initiates a P2P connection to a device with the specified configuration.
    The result of initiating the P2P connection is notified by the callback passed by your application.
    Before calling this method, ensure that the WifiP2pController object has been initialized using the init(ohos.eventhandler.EventRunner,ohos.wifi.p2p.WifiP2pCallback) method.
    
    参数:
    
    wifiP2pConfig - Indicates the P2P configuration of the device to connect to.
    
    callback - Indicates the callback that is invoked to notify the result of initiating the P2P connection.
    
    抛出:
    
    RemoteException - Throws this exception if the WifiP2pController object is not initialized.
    
    从以下版本开始:
    
    3
  - cancelConnect
```
public void cancelConnect(WifiP2pCallback callback)
                   throws RemoteException
```
    Cancels a P2P connection that has been initiated.
    The cancellation result is notified by the callback passed by your application.
    Before calling this method, ensure that the WifiP2pController object has been initialized using the init(ohos.eventhandler.EventRunner,ohos.wifi.p2p.WifiP2pCallback) method.
    
    参数:
    
    callback - Indicates the callback that is invoked to notify the cancellation result.
    
    抛出:
    
    RemoteException - Throws this exception if the WifiP2pController object is not initialized.
    
    从以下版本开始:
    
    3

类 WifiP2pController

字段概要

方法概要

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

字段详细资料

DEVICE_INFO_REQUEST

DEVICE_LIST_REQUEST

GROUP_INFO_REQUEST

NETWORK_INFO_REQUEST

方法详细资料

getInstance

init

discoverDevices

stopDeviceDiscovery

createGroup

removeGroup

requestP2pInfo

connect

cancelConnect