鸿蒙OS P2P功能章

场景介绍

WLAN P2P 功能用于设备与设备之间的点对点数据传输，应用可以通过接口完成以下功能：

1. 发现对端设备。
2. 建立与移除群组。
3. 向对端设备发起连接。
4. 获取 P2P 相关信息。

接口说明

WifiP2pController 提供 WLAN P2P 功能，接口说明如下。

接口名	描述	所需权限
init(EventRunner eventRunner, WifiP2pCallback callback)	初始化 P2P 的信使，当且仅当信使被成功初始化，P2P 的其他功能才可以正常使用。	ohos.permission.GET_WIFI_INFOohos.permission.SET_WIFI_INFO
discoverDevices(WifiP2pCallback callback)	搜索附近可用的 P2P 设备。	ohos.permission.GET_WIFI_INFO
stopDeviceDiscovery(WifiP2pCallback callback)	停止搜索附近的 P2P  设备。	ohos.permission.GET_WIFI_INFO
createGroup(WifiP2pConfig wifiP2pConfig, WifiP2pCallback callback)	建立 P2P 群组。	ohos.permission.GET_WIFI_INFO
removeGroup(WifiP2pCallback callback)	移除 P2P 群组。	ohos.permission.GET_WIFI_INFO
requestP2pInfo(int requestType, WifiP2pCallback callback)	请求 P2P 相关信息，如群组信息、连接信息、设备信息等。	ohos.permission.GET_WIFI_INFO
connect(WifiP2pConfig wifiP2pConfig, WifiP2pCallback callback)	向指定设备发起连接。	ohos.permission.GET_WIFI_INFO
cancelConnect(WifiP2pCallback callback)	取消向指定设备发起的连接。	ohos.permission.GET_WIFI_INFO

启动与停止 P2P 搜索的开发步骤

1. 调用 WifiP2pController 的 getInstance(Context context) 接口，获取 P2P 控制器实例，用于管理 P2P 操作。

1. 调用 init(EventRunner eventRunner, WifiP2pCallback callback)初始化 P2P 控制器实例。

1. 发起 P2P 搜索。

1. 获取 P2P 搜索回调信息。

1. 停止 P2P 搜索。

   try {
       // 获取P2P管理对象
       WifiP2pController wifiP2pController = WifiP2pController.getInstance(this);
       // 初始化P2P管理对象，用于建立P2P信使等行为
       wifiP2pController.init(EventRunner.create(true), null);
       // 创建P2P回调对象
       P2pDiscoverCallBack p2pDiscoverCallBack = new P2pDiscoverCallBack();
       // 发起P2P搜索
       wifiP2pController.discoverDevices(p2pDiscoverCallBack);
       // 停止P2P搜索
       wifiP2pController.stopDeviceDiscovery(p2pDiscoverCallBack);
   } catch (RemoteException re) {
       HiLog.warn(LABEL, "exception happened.");
   }

    
   // 获取P2P启动与停止搜索的回调信息（失败或者成功）
   private class P2pDiscoverCallBack extends WifiP2pCallback {
       @Override
       public void eventExecFail(int reason) {
           HiLog.info(LABEL, "discoverDevices eventExecFail reason : %{public}d", reason);
       }

    
       @Override
       public void eventExecOk() {
           HiLog.info(LABEL, "discoverDevices eventExecOk");
       }
   }

创建与移除群组的开发步骤

1. 调用 WifiP2pController 的 getInstance(Context context)接口，获取 P2P 控制器实例，用于管理 P2P 操作。

1. 调用 init(EventRunner eventRunner, WifiP2pCallback callback)初始化 P2P 控制器实例。

1. 创建 P2P 群组。

1. 移除 P2P 群组。

   try {
       // 获取P2P管理对象
       WifiP2pController wifiP2pController = WifiP2pController.getInstance(this);
       // 初始化P2P管理对象，用于建立P2P信使等行为
       wifiP2pController.init(EventRunner.create(true), null);
       // 创建用于P2P建组需要的配置
       WifiP2pConfig wifiP2pConfig = new WifiP2pConfig("DEFAULT_GROUP_NAME", "DEFAULT_PASSPHRASE");
       wifiP2pConfig.setDeviceAddress("02:02:02:02:03:04");
       wifiP2pConfig.setGroupOwnerBand(0);
       // 创建P2P回调对象
       P2pCreateGroupCallBack p2pCreateGroupCallBack = new P2pCreateGroupCallBack();
       // 创建P2P群组
       wifiP2pController.createGroup(wifiP2pConfig, p2pCreateGroupCallBack);
       // 移除P2P群组
       wifiP2pController.removeGroup(p2pCreateGroupCallBack);
   } catch (RemoteException re) {
       HiLog.warn(LABEL, "exception happened.");
   }

    
   private class P2pCreateGroupCallBack extends WifiP2pCallback {
       @Override
       public void eventExecFail(int reason) {
           HiLog.info(LABEL, "CreateGroup eventExecFail reason : %{public}d", reason);
       }

    
       @Override
       public void eventExecOk() {
           HiLog.info(LABEL, "CreateGroup eventExecOk");
       }
   }

发起 P2P 连接的开发步骤

1. 调用 WifiP2pController 的 getInstance(Context context) 接口，获取 P2P 控制器实例，用于管理 P2P 操作。

1. 调用 init(EventRunner eventRunner, WifiP2pCallback callback)初始化 P2P 控制器实例。

1. 调用 requestP2pInfo()查询 P2P 可用设备信息。

1. 根据场景不同，从可用设备信息中选择目标设备。

1. 调用 connect 接口发起连接。

   try {
       // 获取P2P管理对象
       WifiP2pController wifiP2pController = WifiP2pController.getInstance(this);
       // 初始化P2P管理对象，用于建立P2P信使等行为
       wifiP2pController.init(EventRunner.create(true), null);
       // 查询可用P2P设备信息，通过回调获取P2P设备信息
       P2pRequestPeersCallBack p2pRequestPeersCallBack = new P2pRequestPeersCallBack();
       wifiP2pController.requestP2pInfo(WifiP2pController.DEVICE_LIST_REQUEST, p2pRequestPeersCallBack);
   } catch (RemoteException re) {
       HiLog.warn(LABEL, "exception happened.");
   }

    
   private class P2pRequestPeersCallBack extends WifiP2pCallback {
       @Override
       public void eventP2pDevicesList(List<WifiP2pDevice> devices) {
           HiLog.info(LABEL, "eventP2pDevicesList when start connect group");
           // 根据场景不同，选择不同的设备进行连接，这里，通过MAC地址搜索到指定设备
           WifiP2pConfig wifiP2pConfig = getSameP2pConfigFromDevices(devices);
           try {
               if (wifiP2pConfig != null) {
                   // 向指定的设备发起连接
                   wifiP2pController.connect(wifiP2pConfig, null);
                   }
           } catch (RemoteException re) {
               HiLog.warn(LABEL, "exception happened in connect.");
           }
       }
   }

    
   private WifiP2pConfig getSameP2pConfigFromDevices(List<WifiP2pDevice> devices) {
       if (devices == null) {
           return null;
       }
       for (int i = 0; i < devices.size(); i++) {
           WifiP2pDevice p2pDevice = devices.get(i);
           HiLog.info(LABEL, "p2pDevice.getDeviceAddress() : %{private}s", p2pDevice.getDeviceAddress());
           if (p2pDevice.getDeviceAddress() != null
                   && p2pDevice.getDeviceAddress().equals(TARGET_P2P_MAC_ADDRESS)) {
               HiLog.info(LABEL, "received same mac address");
               WifiP2pConfig wifiP2pConfig = new WifiP2pConfig("DEFAULT_GROUP_NAME", "DEFAULT_PASSPHRASE");
               wifiP2pConfig.setDeviceAddress(p2pDevice.getDeviceAddress());
               return wifiP2pConfig;
           }
       }
       return null;
   }

请求P2P相关信息的开发步骤

1. 调用 WifiP2pController 的 getInstance()接口，获取 P2P 控制器实例，用于管理 P2P 操作。

1. 调用 init()初始化 P2P 控制器实例。

1. 调用 requestP2pInfo()查询 P2P 群组信息。

1. 调用 requestP2pInfo()查询 P2P 设备信息。

1. 根据场景不同，可以调用 requestP2pInfo 获取需要的信息。

   try {
       // 获取P2P管理对象
       WifiP2pController wifiP2pController = WifiP2pController.getInstance(this);
       // 初始化P2P管理对象，用于建立P2P信使等行为
       wifiP2pController.init(EventRunner.create(true), null);
       // 查询可用P2P群组信息，通过回调获取P2P群组信息
       P2pRequestGroupInfoCallBack p2pRequestGroupInfoCallBack = new P2pRequestGroupInfoCallBack();
       wifiP2pController.requestP2pInfo(WifiP2pController.GROUP_INFO_REQUEST, p2pRequestGroupInfoCallBack);
       // 查询可用P2P设备信息，通过回调获取P2P设备信息
       P2pRequestDeviceInfoCallBack p2pRequestDeviceInfoCallBack = new P2pRequestDeviceInfoCallBack();
       wifiP2pController.requestP2pInfo(WifiP2pController.DEVICE_INFO_REQUEST, p2pRequestDeviceInfoCallBack);
       // 通过调用requestP2pInfo接口，可以查询以下关键信息
       wifiP2pController.requestP2pInfo(WifiP2pController.NETWORK_INFO_REQUEST, callback); // 网络信息
       wifiP2pController.requestP2pInfo(WifiP2pController.DEVICE_LIST_REQUEST, callback); // 设备列表信息
   } catch (RemoteException re) {
       HiLog.warn(LABEL, "exception happened.");
   }

    
   // 群组信息回调
   private class P2pRequestGroupInfoCallBack extends WifiP2pCallback {
       @Override
       public void eventP2pGroup(WifiP2pGroup group) {
           HiLog.info(LABEL, "P2pRequestGroupInfoCallBack eventP2pGroup");
           doSthFor(group);
       }
   }
   // 设备信息回调
   private class P2pRequestDeviceInfoCallBack extends WifiP2pCallback {
       @Override
       public void eventP2pGroup(WifiP2pDevice p2pDevice) {
           HiLog.info(LABEL, "eventP2pGroup");
               doSthFor(p2pDevice);
       }
   }