เผยแพร่และสมัครรับข้อมูล

Nearby Messages เป็น API แบบเผยแพร่และสมัครรับข้อมูลที่ช่วยให้อุปกรณ์ที่อยู่ใกล้เคียงแลกเปลี่ยนเพย์โหลดข้อมูลขนาดเล็กได้ เมื่ออุปกรณ์เผยแพร่ข้อความ อุปกรณ์ที่อยู่ใกล้เคียงจะได้รับข้อความดังกล่าว คู่มือนี้จะแนะนำฟังก์ชันการทำงานทั้งหมดที่แอปของคุณต้องใช้เพื่อเผยแพร่และสมัครรับข้อมูลข้อความโดยใช้ Nearby Messages API

ระบบจะกำหนดชุดอุปกรณ์ที่อยู่ใกล้เคียงโดยการแลกเปลี่ยนโทเค็นขนาดเล็กผ่านบลูทูธ เมื่ออุปกรณ์ตรวจพบโทเค็นจากอุปกรณ์ที่อยู่ใกล้เคียง อุปกรณ์จะส่งโทเค็นไปยังเซิร์ฟเวอร์ Nearby Messages เพื่อตรวจสอบและดูว่ามีข้อความที่จะส่งสำหรับการสมัครรับข้อมูลชุดปัจจุบันของแอปพลิเคชันหรือไม่

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

เมื่อเผยแพร่และสมัครรับข้อมูลอย่างแข็งขัน ระบบจะแสดงการแจ้งเตือน "Nearby กำลังใช้งานอยู่" เพื่อแจ้งให้ผู้ใช้ทราบว่า Nearby ทำงานอยู่ การแจ้งเตือนนี้จะแสดงขึ้นเมื่อมีแอปอย่างน้อย 1 แอปกำลังใช้ Nearby อยู่ ซึ่งจะช่วยให้ผู้ใช้ประหยัดแบตเตอรี่ได้หากไม่จำเป็นต้องใช้ Nearby โดยผู้ใช้จะมีตัวเลือกดังนี้

  • ไปที่แอปเพื่อปิดใช้ Nearby
  • บังคับให้แอปหยุดใช้ Nearby
  • ไปที่หน้าจอการตั้งค่า Nearby

คุณสามารถใช้ PublishCallback() และ SubscribeCallback() เพื่อฟังกรณีที่ผู้ใช้บังคับให้แอปหยุดใช้ Nearby เมื่อเกิดเหตุการณ์นี้ ระบบจะทริกเกอร์เมธอด onExpired()

เนื่องจาก Nearby Messages API อาจส่งผลต่ออายุการใช้งานแบตเตอรี่ จึงควรใช้ API เหล่านี้จากกิจกรรมเบื้องหน้าเท่านั้น (ยกเว้น การสมัครรับข้อมูลเบื้องหลัง BLE)

เรียก publish() และ/หรือ subscribe() เพื่อใช้ Nearby Messages API แอปของคุณควร อย่างสมมาตร unpublish() และ unsubscribe() ใน onStop() เสมอ

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ...
    mMessageListener = new MessageListener() {
        @Override
        public void onFound(Message message) {
            Log.d(TAG, "Found message: " + new String(message.getContent()));
        }

        @Override
        public void onLost(Message message) {
            Log.d(TAG, "Lost sight of message: " + new String(message.getContent()));
        }
    }

    mMessage = new Message("Hello World".getBytes());
}

@Override
public void onStart() {
    super.onStart();
    ...
    Nearby.getMessagesClient(this).publish(mMessage);
    Nearby.getMessagesClient(this).subscribe(mMessageListener);
}

@Override
public void onStop() {
    Nearby.getMessagesClient(this).unpublish(mMessage);
    Nearby.getMessagesClient(this).unsubscribe(mMessageListener);
    ...
    super.onStop();
}

เผยแพร่ข้อความ

หากต้องการเผยแพร่ข้อความ ให้เรียก Nearby.getMessagesClient(Activity).publish() โดยส่งอาร์เรย์ไบต์ของข้อความ เราขอแนะนำให้เก็บข้อความไว้ไม่เกิน 3 KB เนื่องจากข้อความเหล่านี้จะส่งได้เร็วกว่า แต่เราสามารถรองรับได้สูงสุด 100 KB สำหรับแอปที่ต้องการ บริการนี้ไม่ได้มีไว้สำหรับการแลกเปลี่ยนออบเจ็กต์ขนาดใหญ่ เช่น รูปภาพและวิดีโอ

คุณสามารถเรียก PublishOptions.setStrategy() เพื่อตั้งค่ากลยุทธ์ ที่จะใช้ได้

ตัวอย่างต่อไปนี้แสดงการเรียก publish() เพื่อส่งข้อความขนาดเล็ก

private void publish(String message) {
    Log.i(TAG, "Publishing message: " + message);
    mActiveMessage = new Message(message.getBytes());
    Nearby.getMessagesClient(this).publish(mActiveMessage);
}

เลิกเผยแพร่ข้อความ

หากต้องการเลิกเผยแพร่ข้อความ ให้เรียก unpublish() แอปของคุณควรเรียกเลิกเผยแพร่ในเมธอด onStop()อย่างน้อย ส่งออบเจ็กต์ Message เดียวกันกับที่ใช้ในการเผยแพร่ (mActiveMessage ในตัวอย่างนี้)

ตัวอย่างโค้ดต่อไปนี้แสดงการเรียก unpublish()

private void unpublish() {
    Log.i(TAG, "Unpublishing.");
    if (mActiveMessage != null) {
        Nearby.getMessagesClient(this).unpublish(mActiveMessage);
        mActiveMessage = null;
    }
}

สมัครรับข้อมูลข้อความ

หากต้องการสมัครรับข้อมูลข้อความจากอุปกรณ์อื่นๆ ให้เรียก Nearby.getMessagesClient(Activity).subscribe() คุณจะต้องส่ง a MessageListener เพื่อจัดการการรับข้อความที่สมัครรับข้อมูล

คุณสามารถเรียก SubscribeOptions.setStrategy() เพื่อตั้งค่ากลยุทธ์ ที่จะใช้ได้

ตัวอย่างต่อไปนี้แสดงการสมัครรับข้อมูลข้อความ

public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ...
    mMessageListener = new MessageListener() {
        @Override
        public void onFound(Message message) {
            Log.d(TAG, "Found message: " + new String(message.getContent()));
        }

        @Override
        public void onLost(Message message) {
            Log.d(TAG, "Lost sight of message: " + new String(message.getContent()));
        }
    }
}

// Subscribe to receive messages.
private void subscribe() {
    Log.i(TAG, "Subscribing.");
    Nearby.getMessagesClient(this).subscribe(mMessageListener, options);
}

ยกเลิกการสมัคร

หากต้องการยกเลิกการสมัครและหยุดรับข้อความจากอุปกรณ์ ให้เรียก Nearby.getMessagesClient(Activity).unsubscribe() ส่งออบเจ็กต์ MessageListener เดียวกันกับที่ใช้ในการสมัครรับข้อมูล (mMessageListener ในตัวอย่างนี้)

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

private void unsubscribe() {
    Log.i(TAG, "Unsubscribing.");
    Nearby.getMessagesClient(this).unsubscribe(mMessageListener);
}