鸿蒙OS P2P功能章

场景介绍

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

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

接口说明

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

启动与停止 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);
       }
   }