鴻蒙OS P2P功能章

場景介紹

WLAN P2P 功能用于設(shè)備與設(shè)備之間的點(diǎn)對(duì)點(diǎn)數(shù)據(jù)傳輸，應(yīng)用可以通過接口完成以下功能：

1. 發(fā)現(xiàn)對(duì)端設(shè)備。
2. 建立與移除群組。
3. 向?qū)Χ嗽O(shè)備發(fā)起連接。
4. 獲取 P2P 相關(guān)信息。

接口說明

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

啟動(dòng)與停止 P2P 搜索的開發(fā)步驟

1. 調(diào)用 WifiP2pController 的 getInstance(Context context) 接口，獲取 P2P 控制器實(shí)例，用于管理 P2P 操作。

1. 調(diào)用 init(EventRunner eventRunner, WifiP2pCallback callback)初始化 P2P 控制器實(shí)例。

1. 發(fā)起 P2P 搜索。

1. 獲取 P2P 搜索回調(diào)信息。

1. 停止 P2P 搜索。

   try {
       // 獲取P2P管理對(duì)象
       WifiP2pController wifiP2pController = WifiP2pController.getInstance(this);
       // 初始化P2P管理對(duì)象，用于建立P2P信使等行為
       wifiP2pController.init(EventRunner.create(true), null);
       // 創(chuàng)建P2P回調(diào)對(duì)象
       P2pDiscoverCallBack p2pDiscoverCallBack = new P2pDiscoverCallBack();
       // 發(fā)起P2P搜索
       wifiP2pController.discoverDevices(p2pDiscoverCallBack);
       // 停止P2P搜索
       wifiP2pController.stopDeviceDiscovery(p2pDiscoverCallBack);
   } catch (RemoteException re) {
       HiLog.warn(LABEL, "exception happened.");
   }

    
   // 獲取P2P啟動(dòng)與停止搜索的回調(diào)信息（失敗或者成功）
   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");
       }
   }

創(chuàng)建與移除群組的開發(fā)步驟

1. 調(diào)用 WifiP2pController 的 getInstance(Context context)接口，獲取 P2P 控制器實(shí)例，用于管理 P2P 操作。

1. 調(diào)用 init(EventRunner eventRunner, WifiP2pCallback callback)初始化 P2P 控制器實(shí)例。

1. 創(chuàng)建 P2P 群組。

1. 移除 P2P 群組。

   try {
       // 獲取P2P管理對(duì)象
       WifiP2pController wifiP2pController = WifiP2pController.getInstance(this);
       // 初始化P2P管理對(duì)象，用于建立P2P信使等行為
       wifiP2pController.init(EventRunner.create(true), null);
       // 創(chuàng)建用于P2P建組需要的配置
       WifiP2pConfig wifiP2pConfig = new WifiP2pConfig("DEFAULT_GROUP_NAME", "DEFAULT_PASSPHRASE");
       wifiP2pConfig.setDeviceAddress("02:02:02:02:03:04");
       wifiP2pConfig.setGroupOwnerBand(0);
       // 創(chuàng)建P2P回調(diào)對(duì)象
       P2pCreateGroupCallBack p2pCreateGroupCallBack = new P2pCreateGroupCallBack();
       // 創(chuàng)建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");
       }
   }

發(fā)起 P2P 連接的開發(fā)步驟

1. 調(diào)用 WifiP2pController 的 getInstance(Context context) 接口，獲取 P2P 控制器實(shí)例，用于管理 P2P 操作。

1. 調(diào)用 init(EventRunner eventRunner, WifiP2pCallback callback)初始化 P2P 控制器實(shí)例。

1. 調(diào)用 requestP2pInfo()查詢 P2P 可用設(shè)備信息。

1. 根據(jù)場景不同，從可用設(shè)備信息中選擇目標(biāo)設(shè)備。

1. 調(diào)用 connect 接口發(fā)起連接。

   try {
       // 獲取P2P管理對(duì)象
       WifiP2pController wifiP2pController = WifiP2pController.getInstance(this);
       // 初始化P2P管理對(duì)象，用于建立P2P信使等行為
       wifiP2pController.init(EventRunner.create(true), null);
       // 查詢可用P2P設(shè)備信息，通過回調(diào)獲取P2P設(shè)備信息
       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");
           // 根據(jù)場景不同，選擇不同的設(shè)備進(jìn)行連接，這里，通過MAC地址搜索到指定設(shè)備
           WifiP2pConfig wifiP2pConfig = getSameP2pConfigFromDevices(devices);
           try {
               if (wifiP2pConfig != null) {
                   // 向指定的設(shè)備發(fā)起連接
                   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相關(guān)信息的開發(fā)步驟

1. 調(diào)用 WifiP2pController 的 getInstance()接口，獲取 P2P 控制器實(shí)例，用于管理 P2P 操作。

1. 調(diào)用 init()初始化 P2P 控制器實(shí)例。

1. 調(diào)用 requestP2pInfo()查詢 P2P 群組信息。

1. 調(diào)用 requestP2pInfo()查詢 P2P 設(shè)備信息。

1. 根據(jù)場景不同，可以調(diào)用 requestP2pInfo 獲取需要的信息。

   try {
       // 獲取P2P管理對(duì)象
       WifiP2pController wifiP2pController = WifiP2pController.getInstance(this);
       // 初始化P2P管理對(duì)象，用于建立P2P信使等行為
       wifiP2pController.init(EventRunner.create(true), null);
       // 查詢可用P2P群組信息，通過回調(diào)獲取P2P群組信息
       P2pRequestGroupInfoCallBack p2pRequestGroupInfoCallBack = new P2pRequestGroupInfoCallBack();
       wifiP2pController.requestP2pInfo(WifiP2pController.GROUP_INFO_REQUEST, p2pRequestGroupInfoCallBack);
       // 查詢可用P2P設(shè)備信息，通過回調(diào)獲取P2P設(shè)備信息
       P2pRequestDeviceInfoCallBack p2pRequestDeviceInfoCallBack = new P2pRequestDeviceInfoCallBack();
       wifiP2pController.requestP2pInfo(WifiP2pController.DEVICE_INFO_REQUEST, p2pRequestDeviceInfoCallBack);
       // 通過調(diào)用requestP2pInfo接口，可以查詢以下關(guān)鍵信息
       wifiP2pController.requestP2pInfo(WifiP2pController.NETWORK_INFO_REQUEST, callback); // 網(wǎng)絡(luò)信息
       wifiP2pController.requestP2pInfo(WifiP2pController.DEVICE_LIST_REQUEST, callback); // 設(shè)備列表信息
   } catch (RemoteException re) {
       HiLog.warn(LABEL, "exception happened.");
   }

    
   // 群組信息回調(diào)
   private class P2pRequestGroupInfoCallBack extends WifiP2pCallback {
       @Override
       public void eventP2pGroup(WifiP2pGroup group) {
           HiLog.info(LABEL, "P2pRequestGroupInfoCallBack eventP2pGroup");
           doSthFor(group);
       }
   }
   // 設(shè)備信息回調(diào)
   private class P2pRequestDeviceInfoCallBack extends WifiP2pCallback {
       @Override
       public void eventP2pGroup(WifiP2pDevice p2pDevice) {
           HiLog.info(LABEL, "eventP2pGroup");
               doSthFor(p2pDevice);
       }
   }