จัดการการเชื่อมต่อ

เริ่มต้นการเชื่อมต่อ

เมื่อพบอุปกรณ์ที่อยู่ใกล้เคียง ผู้ค้นพบจะสามารถเริ่มการเชื่อมต่อได้ ตัวอย่างต่อไปนี้จะขอการเชื่อมต่อกับอุปกรณ์ทันทีที่ค้นพบ

private final EndpointDiscoveryCallback endpointDiscoveryCallback =
    new EndpointDiscoveryCallback() {
      @Override
      public void onEndpointFound(String endpointId, DiscoveredEndpointInfo info) {
        // An endpoint was found. We request a connection to it.
        Nearby.getConnectionsClient(context)
            .requestConnection(getLocalUserName(), endpointId, connectionLifecycleCallback)
            .addOnSuccessListener(
                (Void unused) -> {
                  // We successfully requested a connection. Now both sides
                  // must accept before the connection is established.
                })
            .addOnFailureListener(
                (Exception e) -> {
                  // Nearby Connections failed to request the connection.
                });
      }

      @Override
      public void onEndpointLost(String endpointId) {
        // A previously discovered endpoint has gone away.
      }
    };

คุณอาจต้องแสดงรายการอุปกรณ์ที่ค้นพบแก่ผู้ใช้แทน ซึ่งอุปกรณ์เหล่านี้สามารถเลือกอุปกรณ์ที่จะเชื่อมต่อได้

ยอมรับหรือปฏิเสธการเชื่อมต่อ

หลังจากผู้ค้นพบส่งคําขอเชื่อมต่อกับผู้ลงโฆษณาแล้ว ทั้ง 2 ฝ่ายจะได้รับแจ้งเกี่ยวกับกระบวนการเริ่มต้นการเชื่อมต่อผ่านเมธอด onConnectionInitiated() ของโค้ดเรียกกลับ ConnectionLifecycleCallback โปรดทราบว่าโค้ดเรียกกลับนี้จะส่งให้กับ startAdvertising() ในผู้ลงโฆษณา และ requestConnection() ในเครื่องมือค้นหา แต่นับจากนี้เป็นต้นไป API ดังกล่าวจะเป็นแบบสมมาตร

ในตอนนี้ทั้ง 2 ฝั่งต้องเลือกว่าจะยอมรับหรือปฏิเสธการเชื่อมต่อผ่านการโทรไปยัง acceptConnection() หรือ rejectConnection() ตามลําดับ การเชื่อมต่อจะเริ่มต้นขึ้นโดยสมบูรณ์เมื่อทั้ง 2 ฝั่งยอมรับ หากถูกปฏิเสธหรือทั้ง 2 กรณี ระบบจะยกเลิกการเชื่อมต่อ แต่ไม่ว่าวิธีใด ระบบจะส่งผลการค้นหาไปยัง onConnectionResult()

ข้อมูลโค้ดต่อไปนี้จะแสดงวิธีใช้โค้ดเรียกกลับนี้

private final ConnectionLifecycleCallback connectionLifecycleCallback =
    new ConnectionLifecycleCallback() {
      @Override
      public void onConnectionInitiated(String endpointId, ConnectionInfo connectionInfo) {
        // Automatically accept the connection on both sides.
        Nearby.getConnectionsClient(context).acceptConnection(endpointId, payloadCallback);
      }

      @Override
      public void onConnectionResult(String endpointId, ConnectionResolution result) {
        switch (result.getStatus().getStatusCode()) {
          case ConnectionsStatusCodes.STATUS_OK:
            // We're connected! Can now start sending and receiving data.
            break;
          case ConnectionsStatusCodes.STATUS_CONNECTION_REJECTED:
            // The connection was rejected by one or both sides.
            break;
          case ConnectionsStatusCodes.STATUS_ERROR:
            // The connection broke before it was able to be accepted.
            break;
          default:
            // Unknown status code
        }
      }

      @Override
      public void onDisconnected(String endpointId) {
        // We've been disconnected from this endpoint. No more data can be
        // sent or received.
      }
    };

ขอย้ําอีกครั้งว่า ตัวอย่างนี้จะแสดงการเชื่อมต่อที่ยอมรับโดยอัตโนมัติทั้ง 2 ฝั่ง ทั้งนี้ขึ้นอยู่กับกรณีการใช้งานของคุณ คุณอาจต้องแสดงตัวเลือกนี้ต่อผู้ใช้ในทางใดทางหนึ่ง

ตรวจสอบสิทธิ์การเชื่อมต่อ

เมื่อมีการขอการเชื่อมต่อ แอปของคุณจะตรวจสอบสิทธิ์การเชื่อมต่อได้โดยใช้โทเค็นการตรวจสอบสิทธิ์ที่มอบให้กับ onConnectionInitiated() ซึ่งเป็นวิธีให้ผู้ใช้ยืนยันว่ากําลังเชื่อมต่อกับอุปกรณ์ที่ต้องการ อุปกรณ์ทั้ง 2 เครื่องจะได้รับโทเค็นเดียวกันซึ่งเป็นสตริงสั้นๆ แบบสุ่ม คุณมีหน้าที่ตัดสินใจว่าจะยืนยันอย่างไร ซึ่งโดยปกติจะแสดงโทเค็นในอุปกรณ์ทั้งสองและขอให้ผู้ใช้เปรียบเทียบและยืนยันด้วยตนเอง เช่นเดียวกับกล่องโต้ตอบการจับคู่บลูทูธ

ข้อควรระวัง: แม้ว่าการตรวจสอบสิทธิ์จะไม่บังคับ แต่การเชื่อมต่อที่สร้างขึ้นโดยไม่มีการตรวจสอบสิทธิ์ไม่ปลอดภัยและอาจทําให้อุปกรณ์มีช่องโหว่ด้านความปลอดภัยที่รุนแรง โปรดใช้การตรวจสอบสิทธิ์เพื่อปกป้องการเชื่อมต่อเสมอเพื่อหลีกเลี่ยงปัญหานี้

โค้ดตัวอย่างนี้จะแสดงวิธีการตรวจสอบสิทธิ์วิธีหนึ่งโดยแสดงโทเค็นการตรวจสอบสิทธิ์แก่ผู้ใช้ใน AlertDialog

@Override
public void onConnectionInitiated(String endpointId, ConnectionInfo info) {
  new AlertDialog.Builder(context)
      .setTitle("Accept connection to " + info.getEndpointName())
      .setMessage("Confirm the code matches on both devices: " + info.getAuthenticationDigits())
      .setPositiveButton(
          "Accept",
          (DialogInterface dialog, int which) ->
              // The user confirmed, so we can accept the connection.
              Nearby.getConnectionsClient(context)
                  .acceptConnection(endpointId, payloadCallback))
      .setNegativeButton(
          android.R.string.cancel,
          (DialogInterface dialog, int which) ->
              // The user canceled, so we should reject the connection.
              Nearby.getConnectionsClient(context).rejectConnection(endpointId))
      .setIcon(android.R.drawable.ic_dialog_alert)
      .show();
}