Wi-Fi Direct (點對點或 P2P) 總覽

Wi-Fi Direct (P2P) 可讓具有合適硬體的裝置直接連接至各個 且沒有中繼存取點。這些 API 可讓您 可以發現每部裝置都支援 Wi-Fi P2P 並與其連線，然後 連線速度遠超過 藍牙連線。對於在不同應用程式間共用資料的應用程式而言，這也能派上用場 使用者，例如多人對戰遊戲或相片分享應用程式。

Wi-Fi P2P API 包含下列主要部分：

• 您可以運用哪些方法 探索、要求及連結同類應用程式 WifiP2pManager 類別。
• 可讓您在 WifiP2pManager 方法呼叫。呼叫 WifiP2pManager 方法時，每個 方法可接收以參數傳入的特定事件監聽器。
• 在 Wi-Fi P2P 偵測到的特定事件時通知您的意圖 例如連線中斷或新發現的對等互連項目。

您會經常同時使用這兩個 API 的三大元件。適用對象 例如，您可以提供 WifiP2pManager.ActionListener敬上 對 discoverPeers()。 如此一來 ActionListener.onSuccess() 和 ActionListener.onFailure() 都會通知您A 罩杯 WIFI_P2P_PEERS_CHANGED_ACTION敬上 如果 discoverPeers() 方法發現 同業名單已變更

API 總覽

WifiP2pManager 類別提供方法，讓您與 裝置上的 Wi-Fi 硬體可讓您執行各種操作，例如尋找與聯絡同儕。 可執行的動作如下：

表 1. Wi-Fi P2P 方法

WifiP2pManager 種方式 您傳入事件監聽器，這樣 Wi-Fi P2P 架構就能通知您的活動 改為擷取通話狀態可用的事件監聽器介面和相應的 WifiP2pManager 方法呼叫 表格 2 所述使用事件監聽器。

表 2. Wi-Fi P2P 監聽器

Wi-Fi P2P API 會定義在特定 Wi-Fi P2P 時播送的意圖 觸發事件，例如發現新對等程式或裝置連上 Wi-Fi 時 狀態變更。您可以在應用程式中註冊以接收這些意圖： 建立廣播接收器 處理這些意圖：

表 3. Wi-Fi P2P 意圖

建立 Wi-Fi P2P 意圖的廣播接收器

廣播接收器可讓您接收 Android 廣播的意圖 讓應用程式能回應您有興趣的事件 。建立廣播接收器來處理 Wi-Fi P2P 的基本步驟 意圖如下：

1. 建立可擴充 BroadcastReceiver 類別。 適合課程建構函式建立後，您才需要使用 WifiP2pManager 的參數。 WifiP2pManager.Channel，以及這個廣播接收器將進行的活動 註冊身分讓廣播接收器能將更新傳送給 可以使用 Wi-Fi 硬體和通訊功能 頻道。

2. 在廣播接收器中，檢查您感興趣的意圖 的 onReceive()敬上 方法。根據符合下列條件的意圖，執行所有必要動作 。舉例來說，如果廣播接收器收到 WIFI_P2P_PEERS_CHANGED_ACTION 意圖，您可以呼叫 requestPeers() 方法，取得目前偵測到的對等項目清單。

以下程式碼顯示如何建立一般廣播接收器。 廣播接收器使用 WifiP2pManager 物件和活動做為引數 並利用這兩個類別妥善執行必要動作 廣播接收器會收到意圖：

/**
* A BroadcastReceiver that notifies of important Wi-Fi p2p events.
*/
class WiFiDirectBroadcastReceiver(
       private val manager: WifiP2pManager,
       private val channel: WifiP2pManager.Channel,
       private val activity: MyWifiActivity
) : BroadcastReceiver() {

   override fun onReceive(context: Context, intent: Intent) {
       val action: String = intent.action
       when (action) {
           WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION -> {
               // Check to see if Wi-Fi is enabled and notify appropriate activity
           }
           WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION -> {
               // Call WifiP2pManager.requestPeers() to get a list of current peers
           }
           WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION -> {
               // Respond to new connection or disconnections
           }
           WifiP2pManager.WIFI_P2P_THIS_DEVICE_CHANGED_ACTION -> {
               // Respond to this device's wifi state changing
           }
       }
   }
}

/**
* A BroadcastReceiver that notifies of important Wi-Fi p2p events.
*/
public class WiFiDirectBroadcastReceiver extends BroadcastReceiver {

   private WifiP2pManager manager;
   private Channel channel;
   private MyWiFiActivity activity;

   public WiFiDirectBroadcastReceiver(WifiP2pManager manager, Channel channel,
           MyWifiActivity activity) {
       super();
       this.manager = manager;
       this.channel = channel;
       this.activity = activity;
   }

   @Override
   public void onReceive(Context context, Intent intent) {
       String action = intent.getAction();

       if (WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION.equals(action)) {
           // Check to see if Wi-Fi is enabled and notify appropriate activity
       } else if (WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION.equals(action)) {
           // Call WifiP2pManager.requestPeers() to get a list of current peers
       } else if (WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION.equals(action)) {
           // Respond to new connection or disconnections
       } else if (WifiP2pManager.WIFI_P2P_THIS_DEVICE_CHANGED_ACTION.equals(action)) {
           // Respond to this device's wifi state changing
       }
   }
}

在搭載 Android 10 以上版本的裝置上，廣播意圖如下 非黏著度：

WIFI_P2P_CONNECTION_CHANGED_ACTION

應用程式可以使用 requestConnectionInfo(), requestNetworkInfo()、 或 requestGroupInfo() 擷取目前的連線資訊。

WIFI_P2P_THIS_DEVICE_CHANGED_ACTION

應用程式可以使用 requestDeviceInfo() 擷取目前的連線資訊。

建立 Wi-Fi P2P 應用程式

建立 Wi-Fi P2P 應用程式包括建立及註冊廣播 接收應用程式的接收器、搜尋同類應用程式、連線至同類應用程式，以及 或將資料轉移到對等互連以下各節說明如何執行。

初始設定

使用 Wi-Fi P2P API 之前，您必須確保應用程式 存取硬體，且裝置支援 Wi-Fi P2P 通訊協定。如果 系統支援 Wi-Fi P2P，您可以取得 WifiP2pManager 的例項，建立 並註冊廣播接收器，然後開始使用 Wi-Fi P2P API。

1. 要求裝置上的 Wi-Fi 硬體使用權限並宣告 才能取得正確的 Android 版 SDK 最低版本需求 資訊清單：

   <uses-sdk android:minSdkVersion="14" />
   <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
   <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
   <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
   <!-- If your app targets Android 13 (API level 33)
        or higher, you must declare the NEARBY_WIFI_DEVICES permission. -->
   <uses-permission android:name="android.permission.NEARBY_WIFI_DEVICES"
                    <!-- If your app derives location information from
                         Wi-Fi APIs, don't include the "usesPermissionFlags"
                         attribute. -->
                    android:usesPermissionFlags="neverForLocation" />
   <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"
                    <!-- If any feature in your app relies on precise location
                         information, don't include the "maxSdkVersion"
                         attribute. -->
                    android:maxSdkVersion="32" />
   

   除了上述權限以外，下列 API 還需使用位置資訊 要啟用的模式：

   • discoverPeers()
   • discoverServices()
   • requestPeers()

2. 確認 Wi-Fi P2P 是否已開啟且受到支援。這時不妨確認一下 在您的廣播接收器收到 WIFI_P2P_STATE_CHANGED_ACTION 意圖。通知你的 Wi-Fi P2P 活動 並據此做出回應：

   Kotlin

   override fun onReceive(context: Context, intent: Intent) {
   ...
   val action: String = intent.action
   when (action) {
      WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION -> {
          val state = intent.getIntExtra(WifiP2pManager.EXTRA_WIFI_STATE, -1)
          when (state) {
              WifiP2pManager.WIFI_P2P_STATE_ENABLED -> {
                  // Wifi P2P is enabled
              }
              else -> {
                  // Wi-Fi P2P is not enabled
              }
          }
      }
   }
   ...
   }
   

   Java

   @Override
   public void onReceive(Context context, Intent intent) {
   ...
   String action = intent.getAction();
   if (WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION.equals(action)) {
      int state = intent.getIntExtra(WifiP2pManager.EXTRA_WIFI_STATE, -1);
      if (state == WifiP2pManager.WIFI_P2P_STATE_ENABLED) {
          // Wifi P2P is enabled
      } else {
          // Wi-Fi P2P is not enabled
      }
   }
   ...
   }
   

3. 在您活動的 onCreate()敬上 方法，取得 WifiP2pManager 的例項並註冊應用程式 透過呼叫 initialize() 與 Wi-Fi P2P 架構搭配使用。這個方法會傳回一個 WifiP2pManager.Channel，用於將應用程式連結至 Wi-Fi P2P 架構。您也應該建立廣播執行個體 接收端以及 WifiP2pManager 和 WifiP2pManager.Channel 物件 並附上活動參考資料讓廣播接收器能： 通知您的活動，並據此更新相關資訊。此外， 供您在必要時操控裝置的 Wi-Fi 狀態：

   Kotlin

   val manager: WifiP2pManager? by lazy(LazyThreadSafetyMode.NONE) {
      getSystemService(Context.WIFI_P2P_SERVICE) as WifiP2pManager?
   }
   
   var channel: WifiP2pManager.Channel? = null
   var receiver: BroadcastReceiver? = null
   
   override fun onCreate(savedInstanceState: Bundle?) {
      ...
   
      channel = manager?.initialize(this, mainLooper, null)
      channel?.also { channel ->
          receiver = WiFiDirectBroadcastReceiver(manager, channel, this)
      }
   }
   

   Java

   WifiP2pManager manager;
   Channel channel;
   BroadcastReceiver receiver;
   ...
   @Override
   protected void onCreate(Bundle savedInstanceState){
      ...
      manager = (WifiP2pManager) getSystemService(Context.WIFI_P2P_SERVICE);
      channel = manager.initialize(this, getMainLooper(), null);
      receiver = new WiFiDirectBroadcastReceiver(manager, channel, this);
      ...
   }
   

4. 建立意圖篩選器，並新增與廣播接收器相同的意圖 檢查：

   Kotlin

   val intentFilter = IntentFilter().apply {
      addAction(WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION)
      addAction(WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION)
      addAction(WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION)
      addAction(WifiP2pManager.WIFI_P2P_THIS_DEVICE_CHANGED_ACTION)
   }
   

   Java

   IntentFilter intentFilter;
   ...
   @Override
   protected void onCreate(Bundle savedInstanceState){
      ...
      intentFilter = new IntentFilter();
      intentFilter.addAction(WifiP2pManager.WIFI_P2P_STATE_CHANGED_ACTION);
      intentFilter.addAction(WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION);
      intentFilter.addAction(WifiP2pManager.WIFI_P2P_CONNECTION_CHANGED_ACTION);
      intentFilter.addAction(WifiP2pManager.WIFI_P2P_THIS_DEVICE_CHANGED_ACTION);
      ...
   }
   

5. 在 onResume() 方法 然後前往 onPause() 方法 活動：

   Kotlin

   /* register the broadcast receiver with the intent values to be matched */
   override fun onResume() {
      super.onResume()
      receiver?.also { receiver ->
          registerReceiver(receiver, intentFilter)
      }
   }
   
   /* unregister the broadcast receiver */
   override fun onPause() {
      super.onPause()
      receiver?.also { receiver ->
          unregisterReceiver(receiver)
      }
   }
   

   Java

   /* register the broadcast receiver with the intent values to be matched */
   @Override
   protected void onResume() {
      super.onResume();
      registerReceiver(receiver, intentFilter);
   }
   /* unregister the broadcast receiver */
   @Override
   protected void onPause() {
      super.onPause();
      unregisterReceiver(receiver);
   }
   

6. 取得WifiP2pManager.Channel並設定廣播時 則您的應用程式可以撥打 Wi-Fi P2P 方法呼叫 P2P 意圖。

7. 使用 Wi-Fi P2P 功能實作應用程式，方法是呼叫 WifiP2pManager 中的方法。

以下各節將說明如何執行常見操作，例如探索及 與其他應用程式之間的連線

探索同業

呼叫 discoverPeers() 以偵測在有效且可用的對等項目 保持連線狀態。此函式的呼叫為非同步，且成功或 失敗會向您的應用程式傳遞 onSuccess() 和 onFailure() 如果您建立了 WifiP2pManager.ActionListener僅限 onSuccess() 方法 通知您探索程序已順利完成，且未提供 得知實際發現的同類應用程式 (如果有的話) 等資訊。下列 程式碼範例顯示如何設定。

manager?.discoverPeers(channel, object : WifiP2pManager.ActionListener {

   override fun onSuccess() {
       ...
   }

   override fun onFailure(reasonCode: Int) {
       ...
   }
})

manager.discoverPeers(channel, new WifiP2pManager.ActionListener() {
   @Override
   public void onSuccess() {
       ...
   }

   @Override
   public void onFailure(int reasonCode) {
       ...
   }
});

如果探索程序成功並偵測到同儕，系統會廣播 WIFI_P2P_PEERS_CHANGED_ACTION 意圖，可在廣播中監聽 才能取得對等項目清單。應用程式收到 WIFI_P2P_PEERS_CHANGED_ACTION 意圖，您可以要求所找到的清單 與 requestPeers() 為同業。以下程式碼說明如何設定。

override fun onReceive(context: Context, intent: Intent) {
   val action: String = intent.action
   when (action) {
       ...
       WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION -> {
           manager?.requestPeers(channel) { peers: WifiP2pDeviceList? ->
               // Handle peers list
           }
       }
       ...
   }
}

PeerListListener myPeerListListener;
...
if (WifiP2pManager.WIFI_P2P_PEERS_CHANGED_ACTION.equals(action)) {

   // request available peers from the wifi p2p manager. This is an
   // asynchronous call and the calling activity is notified with a
   // callback on PeerListListener.onPeersAvailable()
   if (manager != null) {
       manager.requestPeers(channel, myPeerListListener);
   }
}

requestPeers() 方法也為非同步性質，且可通知活動 如果有同業供應商名單 onPeersAvailable(), 這項定義是在 WifiP2pManager.PeerListListener 介面上定義。 onPeersAvailable() 方法提供 WifiP2pDeviceList， 即可反覆尋找要連結的應用程式

與同業交流

取得可能的同類應用程式清單，並選取要連線的裝置後 ，呼叫 connect() 方法來連線至裝置。這個方法呼叫 需要 WifiP2pConfig 物件，其中包含要連線的裝置相關資訊。 「WifiP2pManager.ActionListener」會在連線成功時通知您 失敗。以下程式碼顯示如何建立與裝置的連線。

val device: WifiP2pDevice = ...
val config = WifiP2pConfig()
config.deviceAddress = device.deviceAddress
channel?.also { channel ->
   manager?.connect(channel, config, object : WifiP2pManager.ActionListener {

       override fun onSuccess() {
           //success logic
       }

       override fun onFailure(reason: Int) {
           //failure logic
       }
   }
)}

//obtain a peer from the WifiP2pDeviceList
WifiP2pDevice device;
WifiP2pConfig config = new WifiP2pConfig();
config.deviceAddress = device.deviceAddress;
manager.connect(channel, config, new ActionListener() {

   @Override
   public void onSuccess() {
       //success logic
   }

   @Override
   public void onFailure(int reason) {
       //failure logic
   }
});

轉移資料

建立連線後，您就能透過 通訊端。轉移資料的基本步驟如下：

1. 建立 ServerSocket。這個通訊端 等待特定通訊埠上的用戶端連線，並封鎖直到連線為止 請在背景執行緒中進行這項操作
2. 建立用戶端 Socket。用戶端會使用 連線至伺服器裝置的伺服器通訊端 IP 位址和通訊埠。
3. 將資料從用戶端傳送至伺服器。用戶端通訊端成功時 會連上伺服器通訊端，您可以從用戶端將資料傳送到 包含位元組串流
4. 伺服器通訊端會等待用戶端連線 ( accept() 方法)。這場通話 會一直封鎖到用戶端連線為止，因此請在其他執行緒中呼叫此呼叫。如果 連線後，伺服器裝置即可接收來自用戶端的資料。

下列範例是從 Wi-Fi P2P 修改而來 操作示範、 說明如何建立這個用戶端與伺服器通訊端的通訊和傳輸 從用戶端到具有服務的伺服器的 JPEG 圖片。處理完整的工作 例如編譯並執行示範

class FileServerAsyncTask(
       private val context: Context,
       private var statusText: TextView
) : AsyncTask<Void, Void, String?>() {

   override fun doInBackground(vararg params: Void): String? {
       /**
        * Create a server socket.
        */
       val serverSocket = ServerSocket(8888)
       return serverSocket.use {
           /**
            * Wait for client connections. This call blocks until a
            * connection is accepted from a client.
            */
           val client = serverSocket.accept()
           /**
            * If this code is reached, a client has connected and transferred data
            * Save the input stream from the client as a JPEG file
            */
           val f = File(Environment.getExternalStorageDirectory().absolutePath +
                   "/${context.packageName}/wifip2pshared-${System.currentTimeMillis()}.jpg")
           val dirs = File(f.parent)

           dirs.takeIf { it.doesNotExist() }?.apply {
               mkdirs()
           }
           f.createNewFile()
           val inputstream = client.getInputStream()
           copyFile(inputstream, FileOutputStream(f))
           serverSocket.close()
           f.absolutePath
       }
   }

   private fun File.doesNotExist(): Boolean = !exists()

   /**
    * Start activity that can handle the JPEG image
    */
   override fun onPostExecute(result: String?) {
       result?.run {
           statusText.text = "File copied - $result"
           val intent = Intent(android.content.Intent.ACTION_VIEW).apply {
               setDataAndType(Uri.parse("file://$result"), "image/*")
           }
           context.startActivity(intent)
       }
   }
}

public static class FileServerAsyncTask extends AsyncTask {

   private Context context;
   private TextView statusText;

   public FileServerAsyncTask(Context context, View statusText) {
       this.context = context;
       this.statusText = (TextView) statusText;
   }

   @Override
   protected String doInBackground(Void... params) {
       try {

           /**
            * Create a server socket and wait for client connections. This
            * call blocks until a connection is accepted from a client
            */
           ServerSocket serverSocket = new ServerSocket(8888);
           Socket client = serverSocket.accept();

           /**
            * If this code is reached, a client has connected and transferred data
            * Save the input stream from the client as a JPEG file
            */
           final File f = new File(Environment.getExternalStorageDirectory() + "/"
                   + context.getPackageName() + "/wifip2pshared-" + System.currentTimeMillis()
                   + ".jpg");

           File dirs = new File(f.getParent());
           if (!dirs.exists())
               dirs.mkdirs();
           f.createNewFile();
           InputStream inputstream = client.getInputStream();
           copyFile(inputstream, new FileOutputStream(f));
           serverSocket.close();
           return f.getAbsolutePath();
       } catch (IOException e) {
           Log.e(WiFiDirectActivity.TAG, e.getMessage());
           return null;
       }
   }

   /**
    * Start activity that can handle the JPEG image
    */
   @Override
   protected void onPostExecute(String result) {
       if (result != null) {
           statusText.setText("File copied - " + result);
           Intent intent = new Intent();
           intent.setAction(android.content.Intent.ACTION_VIEW);
           intent.setDataAndType(Uri.parse("file://" + result), "image/*");
           context.startActivity(intent);
       }
   }
}

在用戶端上透過用戶端通訊端連線至伺服器通訊端，然後傳輸 資料。此範例在用戶端裝置的檔案系統中傳輸 JPEG 檔案。

val context = applicationContext
val host: String
val port: Int
val len: Int
val socket = Socket()
val buf = ByteArray(1024)
...
try {
   /**
    * Create a client socket with the host,
    * port, and timeout information.
    */
   socket.bind(null)
   socket.connect((InetSocketAddress(host, port)), 500)

   /**
    * Create a byte stream from a JPEG file and pipe it to the output stream
    * of the socket. This data is retrieved by the server device.
    */
   val outputStream = socket.getOutputStream()
   val cr = context.contentResolver
   val inputStream: InputStream = cr.openInputStream(Uri.parse("path/to/picture.jpg"))
   while (inputStream.read(buf).also { len = it } != -1) {
       outputStream.write(buf, 0, len)
   }
   outputStream.close()
   inputStream.close()
} catch (e: FileNotFoundException) {
   //catch logic
} catch (e: IOException) {
   //catch logic
} finally {
   /**
    * Clean up any open sockets when done
    * transferring or if an exception occurred.
    */
   socket.takeIf { it.isConnected }?.apply {
       close()
   }
}

Context context = this.getApplicationContext();
String host;
int port;
int len;
Socket socket = new Socket();
byte buf[]  = new byte[1024];
...
try {
   /**
    * Create a client socket with the host,
    * port, and timeout information.
    */
   socket.bind(null);
   socket.connect((new InetSocketAddress(host, port)), 500);

   /**
    * Create a byte stream from a JPEG file and pipe it to the output stream
    * of the socket. This data is retrieved by the server device.
    */
   OutputStream outputStream = socket.getOutputStream();
   ContentResolver cr = context.getContentResolver();
   InputStream inputStream = null;
   inputStream = cr.openInputStream(Uri.parse("path/to/picture.jpg"));
   while ((len = inputStream.read(buf)) != -1) {
       outputStream.write(buf, 0, len);
   }
   outputStream.close();
   inputStream.close();
} catch (FileNotFoundException e) {
   //catch logic
} catch (IOException e) {
   //catch logic
}

/**
* Clean up any open sockets when done
* transferring or if an exception occurred.
*/
finally {
   if (socket != null) {
       if (socket.isConnected()) {
           try {
               socket.close();
           } catch (IOException e) {
               //catch logic
           }
       }
   }
}