ภาพรวม 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" />
    

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

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