ภาพรวม Wi-Fi Direct (เพียร์ทูเพียร์ หรือ P2P)

Wi-Fi Direct (P2P) ช่วยให้อุปกรณ์ที่มีฮาร์ดแวร์ที่เหมาะสมเชื่อมต่อกับอุปกรณ์ อื่นๆ ผ่าน Wi-Fi โดยไม่มีจุดเข้าใช้งานขั้นกลาง เมื่อใช้ API เหล่านี้ คุณจะทำสิ่งต่อไปนี้ได้ สำรวจและเชื่อมต่อกับอุปกรณ์อื่นๆ เมื่ออุปกรณ์แต่ละเครื่องรองรับ Wi-Fi P2P สื่อสารผ่านการเชื่อมต่อที่รวดเร็วข้ามระยะทาง นานกว่า การเชื่อมต่อบลูทูธ วิธีนี้เป็นประโยชน์สำหรับแอปพลิเคชันที่แชร์ข้อมูลระหว่าง เช่น เกมผู้เล่นหลายคน หรือแอปพลิเคชันแชร์รูปภาพ

Wi-Fi P2P API ประกอบด้วยส่วนหลักๆ ดังต่อไปนี้

• วิธีที่ช่วยให้คุณค้นพบ ส่งคำขอ และเชื่อมต่อกับแอปเทียบเท่า ที่กำหนดไว้ใน WifiP2pManager
• ผู้ฟังที่ให้คุณรับการแจ้งเตือนเกี่ยวกับความสำเร็จหรือความล้มเหลวของ การเรียกเมธอด WifiP2pManager เมื่อเรียกใช้ WifiP2pManager วิธี แต่ละวิธี สามารถรับ Listener ที่เฉพาะเจาะจงที่ส่งผ่านเป็นพารามิเตอร์ได้
• Intent ที่แจ้งให้คุณทราบถึงเหตุการณ์ที่เจาะจงซึ่ง Wi-Fi P2P ตรวจพบ เช่น การเชื่อมต่อหลุดหรือแอปเทียบเท่าที่เพิ่งค้นพบ

คุณมักจะใช้คอมโพเนนต์หลัก 3 รายการนี้ของ API ร่วมกัน สำหรับ ตัวอย่างเช่น คุณสามารถระบุ WifiP2pManager.ActionListener ถึงการโทรหา discoverPeers() ดังนั้น ActionListener.onSuccess() และ ActionListener.onFailure() สามารถแจ้งให้คุณทราบได้ ต WIFI_P2P_PEERS_CHANGED_ACTION Intent จะประกาศด้วยหากเมธอด discoverPeers() พบว่า รายการแอปเทียบเท่าเปลี่ยนไป

ภาพรวม API

คลาส WifiP2pManager มีวิธีช่วยให้คุณโต้ตอบกับ ฮาร์ดแวร์ Wi-Fi ในอุปกรณ์เพื่อทำสิ่งต่างๆ เช่น ค้นหาและเชื่อมต่อกับแอปเทียบเท่า การดำเนินการที่ทำได้มีดังนี้

ตารางที่ 1 วิธี P2P ผ่าน Wi-Fi

วิธีการ	คำอธิบาย
initialize()	ลงทะเบียนแอปพลิเคชันกับเฟรมเวิร์ก Wi-Fi เรียกใช้ก่อน การเรียกใช้ Wi-Fi P2P วิธีอื่น
connect()	เริ่มการเชื่อมต่อแบบเพียร์ทูเพียร์กับอุปกรณ์ที่มีการกำหนดค่าที่ระบุ
cancelConnect()	ยกเลิกการเจรจาต่อรองแบบกลุ่มแบบ peer-to-peer ที่ดำเนินอยู่
requestConnectInfo()	ขอข้อมูลการเชื่อมต่อของอุปกรณ์
createGroup()	สร้างกลุ่มแบบเพียร์ทูเพียร์ซึ่งมีอุปกรณ์ปัจจุบันเป็นเจ้าของกลุ่ม
removeGroup()	นำกลุ่มเพียร์ทูเพียร์ปัจจุบันออก
requestGroupInfo()	ขอข้อมูลกลุ่มแบบเพียร์ทูเพียร์
discoverPeers()	เริ่มการค้นพบคู่สนทนา
requestPeers()	ขอรายการคู่สนทนาที่ค้นพบในปัจจุบัน

WifiP2pManager เมธอดช่วยให้ ที่คุณส่งผ่าน Listener เพื่อให้เฟรมเวิร์ก Wi-Fi P2P สามารถแจ้งเตือนกิจกรรมของคุณ ของสถานะการโทร อินเทอร์เฟซตัวฟังที่ใช้ได้และการเรียกใช้เมธอด WifiP2pManager ที่เกี่ยวข้องซึ่งใช้ตัวฟังจะอธิบายไว้ในตารางที่ 2

ตาราง 2 อุปกรณ์รับสัญญาณ Wi-Fi P2P

อินเทอร์เฟซ Listener	การดำเนินการที่เกี่ยวข้อง
WifiP2pManager.ActionListener	connect() cancelConnect() createGroup(), removeGroup() และ discoverPeers()
WifiP2pManager.ChannelListener	initialize()
WifiP2pManager.ConnectionInfoListener	requestConnectInfo()
WifiP2pManager.GroupInfoListener	requestGroupInfo()
WifiP2pManager.PeerListListener	requestPeers()

Wi-Fi P2P API กำหนด Intent ที่ประกาศเมื่อ Wi-Fi P2P บางรายการ เกิดเหตุการณ์ เช่น เมื่อพบการเพียร์ใหม่หรือเมื่อ Wi-Fi ของอุปกรณ์ การเปลี่ยนแปลงสถานะ คุณสามารถลงทะเบียนเพื่อรับ Intent เหล่านี้ในแอปพลิเคชันได้โดยสร้าง Broadcast Receiver ที่จัดการ Intent เหล่านี้

ตารางที่ 3 Intent ของ Wi-Fi P2P

ความตั้งใจ	คำอธิบาย
WIFI_P2P_CONNECTION_CHANGED_ACTION	ออกอากาศเมื่อสถานะการเชื่อมต่อ Wi-Fi ของอุปกรณ์มีการเปลี่ยนแปลง
WIFI_P2P_PEERS_CHANGED_ACTION	ประกาศเมื่อโทรหา discoverPeers() ปกติแล้วคุณจะ โทรหา requestPeers() เพื่อดูรายชื่อแอปเทียบเท่าที่อัปเดตหากคุณ จัดการ Intent นี้ในแอปพลิเคชันของคุณได้
WIFI_P2P_STATE_CHANGED_ACTION	ประกาศเมื่อเปิดหรือปิด Wi-Fi P2P ในอุปกรณ์
WIFI_P2P_THIS_DEVICE_CHANGED_ACTION	ประกาศเมื่อรายละเอียดของอุปกรณ์มีการเปลี่ยนแปลง เช่น ชื่ออุปกรณ์

สร้าง Broadcast Receiver สำหรับ Intent แบบ P2P ของ Wi-Fi

Broadcast Receiver ช่วยให้คุณรับ Intent ที่ออกอากาศโดย Android เพื่อให้แอปพลิเคชันของคุณสามารถตอบสนองต่อกิจกรรมที่คุณสนใจ นิ้ว ขั้นตอนพื้นฐานในการสร้าง Broadcast Receiver เพื่อจัดการ Wi-Fi P2P Intent มีดังนี้

1. สร้างคลาสที่ขยายคลาส BroadcastReceiver สําหรับตัวสร้างคลาส คุณจะใช้พารามิเตอร์สําหรับ WifiP2pManager, WifiP2pManager.Channel และกิจกรรมที่จะลงทะเบียนตัวรับการออกอากาศนี้ ซึ่งจะช่วยให้ตัวรับการออกอากาศส่งการอัปเดตไปยังกิจกรรม รวมถึงเข้าถึงฮาร์ดแวร์ Wi-Fi และช่องทางการสื่อสารได้หากจำเป็น

2. ใน Broadcast Receiver ให้ตรวจสอบ Intent ที่คุณสนใจในวิธี onReceive() ดําเนินการที่จําเป็นโดยขึ้นอยู่กับความตั้งใจที่ได้รับ ตัวอย่างเช่น หาก Broadcast Receiver รับสัญญาณ WIFI_P2P_PEERS_CHANGED_ACTION คุณสามารถเรียกใช้ requestPeers() เพื่อรับรายชื่อแอปเทียบเท่าที่ค้นพบในปัจจุบัน

โค้ดต่อไปนี้แสดงวิธีสร้างตัวรับการออกอากาศทั่วไป Broadcast Receiver รับออบเจ็กต์ WifiP2pManager และกิจกรรมเป็นอาร์กิวเมนต์ และใช้ทั้ง 2 คลาสนี้ในการดำเนินการที่จำเป็นอย่างเหมาะสม Broadcast Receiver ต้องการทำสิ่งต่อไปนี้

Kotlin

/**
* 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
           }
       }
   }
}

Java

/**
* 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 ขึ้นไป Intent การออกอากาศต่อไปนี้จะไม่ใช่แบบติดหนึบ

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 คุณต้องตรวจสอบว่าแอปพลิเคชันสามารถ เข้าถึงฮาร์ดแวร์และอุปกรณ์รองรับโปรโตคอล P2P ของ Wi-Fi ถ้า ระบบรองรับ Wi-Fi P2P คุณสามารถรับอินสแตนซ์ของ WifiP2pManager, สร้าง และลงทะเบียน Broadcast Receiver ของคุณ จากนั้นเริ่มใช้ Wi-Fi P2P API

1. ขอสิทธิ์ในการใช้ฮาร์ดแวร์ Wi-Fi ในอุปกรณ์และประกาศว่าแอปพลิเคชันของคุณมีเวอร์ชัน SDK ขั้นต่ำที่ถูกต้องในไฟล์ Manifest ของ Android โดยทำดังนี้

   <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" />
   

   หมายเหตุ: ในแอปที่กำหนดเป้าหมายเป็น Android 13 (API ระดับ 33) ขึ้นไป ทั้ง discoverPeers() และ connect() ต้องใช้สิทธิ์ android.permission.NEARBY_WIFI_DEVICES ในแอปที่กำหนดเป้าหมายเป็น Android เวอร์ชันเก่า วิธีการเหล่านี้ต้องใช้สิทธิ์ ACCESS_FINE_LOCATION แทน ตั้งแต่ปี การอนุญาตเหล่านี้มีอันตราย คุณต้อง ส่งคำขอขณะรันไทม์ก่อน สามารถโทรหา discoverPeers() หรือ connect()

   นอกจากสิทธิ์ก่อนหน้านี้แล้ว API ต่อไปนี้จำเป็นต้องใช้ตำแหน่งด้วย โหมดที่จะเปิดใช้งาน:

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

2. ตรวจสอบว่าเปิดและรองรับ Wi-Fi P2P หรือไม่ คุณสามารถตรวจสอบได้ใน Broadcast Receiver เมื่อได้รับ Intent 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 และลงทะเบียนแอปพลิเคชันของคุณ ด้วยเฟรมเวิร์ก P2P สำหรับ Wi-Fi โดยโทรไปที่ initialize() เมธอดนี้จะแสดงเมธอด 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. สร้างตัวกรอง Intent และเพิ่ม Intent เดียวกับที่ Broadcast Receiver ของคุณ ตรวจสอบ:

   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และตั้งค่าการออกอากาศแล้ว ตัวรับ แอปพลิเคชันของคุณสามารถเรียกใช้วิธี P2P ผ่าน Wi-Fi และรับสาย Wi-Fi ได้ Intent แบบ P2P

7. ติดตั้งใช้งานแอปพลิเคชันของคุณ โดยใช้ฟีเจอร์ P2P ของ Wi-Fi โดยการเรียกใช้ ใน WifiP2pManager

ส่วนถัดไปจะอธิบายวิธีดำเนินการทั่วไป เช่น การค้นหาและการเชื่อมต่อกับอุปกรณ์อื่นๆ

สำรวจแอปที่เทียบเท่า

โทรหา discoverPeers() เพื่อตรวจหาแอปเทียบเท่าที่อยู่ในระยะสัญญาณและพร้อมให้บริการ เพื่อการเชื่อมต่อ การเรียกฟังก์ชันนี้เป็นแบบอะซิงโครนัส และการเรียกที่สำเร็จ หรือ ระบบสื่อสารกับแอปพลิเคชันของคุณด้วย onSuccess() และ onFailure() ไม่สำเร็จ หากคุณสร้าง WifiP2pManager.ActionListener เมธอด onSuccess() จะแจ้งให้คุณทราบว่ากระบวนการค้นพบสําเร็จเท่านั้น และไม่ระบุข้อมูลใดๆ เกี่ยวกับพาร์ทเนอร์จริงที่ค้นพบ (หากมี) ดังต่อไปนี้ ตัวอย่างโค้ดจะแสดงวิธีตั้งค่านี้

Kotlin

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

   override fun onSuccess() {
       ...
   }

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

Java

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

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

หากกระบวนการค้นหาสำเร็จและตรวจพบคู่สนทนา ระบบจะออกอากาศ Intent WIFI_P2P_PEERS_CHANGED_ACTION ซึ่งคุณสามารถรับฟังได้ในเครื่องรับออกอากาศเพื่อดูรายการคู่สนทนา เมื่อแอปพลิเคชันของคุณได้รับWIFI_P2P_PEERS_CHANGED_ACTION Intent คุณจะขอรายชื่อพาร์ทเนอร์ที่ค้นพบได้ด้วย requestPeers() โค้ดต่อไปนี้แสดงวิธีตั้งค่า

Kotlin

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
           }
       }
       ...
   }
}

Java

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 สามารถแจ้งให้คุณทราบเมื่อเชื่อมต่อสำเร็จหรือไม่สำเร็จ รหัสต่อไปนี้แสดงวิธีสร้างการเชื่อมต่อกับอุปกรณ์

Kotlin

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
       }
   }
)}

Java

//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
   }
});

โอนข้อมูล

เมื่อทำการเชื่อมต่อแล้ว คุณสามารถโอนข้อมูลระหว่างอุปกรณ์ที่มี Socket ขั้นตอนพื้นฐานของการโอนข้อมูลมีดังนี้

1. สร้าง ServerSocket ซ็อกเก็ตนี้จะรอการเชื่อมต่อจากไคลเอ็นต์ในพอร์ตที่ระบุและบล็อกจนกว่าการเชื่อมต่อจะเกิดขึ้น ดังนั้นให้ทำในเธรดเบื้องหลัง
2. สร้างไคลเอ็นต์ Socket ไคลเอ็นต์จะใช้ที่อยู่ IP และพอร์ตของซ็อกเก็ตเซิร์ฟเวอร์เพื่อเชื่อมต่อกับอุปกรณ์เซิร์ฟเวอร์
3. ส่งข้อมูลจากไคลเอ็นต์ไปยังเซิร์ฟเวอร์ เมื่อซ็อกเก็ตไคลเอ็นต์เชื่อมต่อกับซ็อกเก็ตเซิร์ฟเวอร์เรียบร้อยแล้ว คุณจะส่งข้อมูลจากไคลเอ็นต์ไปยังเซิร์ฟเวอร์ด้วยสตรีมไบต์ได้
4. ซ็อกเก็ตเซิร์ฟเวอร์จะรอการเชื่อมต่อไคลเอ็นต์ (โดยมี accept()) การโทรนี้ บล็อกจนกว่าไคลเอ็นต์จะเชื่อมต่อ ดังนั้นโปรดเรียกใช้ในชุดข้อความอื่น เมื่อเชื่อมต่อแล้ว อุปกรณ์เซิร์ฟเวอร์จะรับข้อมูลจากไคลเอ็นต์ได้

ตัวอย่างต่อไปนี้ได้รับการแก้ไขจาก Wi-Fi P2P การสาธิต แสดงวิธีสร้างการสื่อสารและโอนซ็อกเก็ตแบบไคลเอ็นต์-เซิร์ฟเวอร์นี้ รูปภาพ JPEG จากไคลเอ็นต์ไปยังเซิร์ฟเวอร์พร้อมกับบริการ เพื่อการทำงานที่สมบูรณ์ เช่น คอมไพล์และเรียกใช้เดโม

Kotlin

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)
       }
   }
}

Java

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 ในระบบไฟล์ของอุปกรณ์ไคลเอ็นต์

Kotlin

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()
   }
}

Java

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
           }
       }
   }
}