Kelas-kelas utama platform BlackBerry Messenger

Kelas

Deskripsi

BBMPlatformContext

Antarmuka BBMPlatformContext memeriksa status akses aplikasi Anda dan memungkinkan Anda mengambil referensi ke layanan yang terkait aplikasi (misalnya, layanan pengiriman pesan, layanan daftar kontak, dan layanan UI).

Platform BlackBerry Messenger akan mengembalikan instance BBMPlatformContext ketika aplikasi Anda mendaftar ke platform BlackBerry Messenger.

Anda dapat menerima pemberitahuan perubahan status akses atau pendaftaran aplikasi Anda dengan mendefinisikan kelas yang memperluas kelas BBMPlatformContextListener beserta metodenya.

MessagingService

Kelas MessagingService memungkinkan Anda membuat instance BBMPlatformChannel atau BBMPlatformSession, mengundang kontak untuk mengunduh aplikasi Anda, atau mengirim file ke kontak BlackBerry Messenger.

Untuk menerima pemberitahuan tentang peristiwa yang terkait dengan layanan pengiriman pesan, Anda harus memperluas kelas abstrak MessagingServiceListener, mengabaikan metode panggilan baliknya, serta mengaktifkan metode MessagingService.setServiceListener().

Untuk mengambil referensi ke MessagingService yang terkait dengan aplikasi Anda, aktifkan BBMPlatformContext.getMessagingService().

BBMPlatformChannel

Antarmuka BBMPlatformChannel menunjukkan koneksi privat antara aplikasi Anda dengan satu kontak atau lebih. Jika aplikasi Anda berkomunikasi dengan banyak kontak, kontak tersebut tidak saling mengetahui. Akibatnya, semua kontak hanya dapat berkomunikasi dengan aplikasi Anda, bukan dengan satu sama lain.

Anda dapat mengaktifkan BBMPlatformConnection.setPublic() untuk menetapkan saluran Anda agar mengizinkan koneksi dari kontak yang tidak termasuk dalam daftar kontak BlackBerry Messenger Anda.

Untuk menerima pemberitahuan tentang peristiwa dan perubahan pada saluran, Anda harus memperluas kelas BBMPlatformChannelListener dan mengabaikan metode panggilan balik dari kelas BBMPlatformConnectionListener.

Untuk membuat instance BBMPlatformChannel, aktifkan MessagingService.createChannel(), kirimkan referensi ke instance BBMPlatformChannelListener.

BBMPlatformSession

Antarmuka BBMPlatformSession menunjukkan koneksi antara kontak BlackBerry Messenger. Apabila Anda membuat koneksi sesi, setiap kontak dalam sesi dapat mengundang kontak atau kontak-kontak lain untuk bergabung dalam sesi tersebut. Setiap kontak dalam sesi tersebut dapat berbagi data.

Anda dapat mengaktifkan BBMPlatformConnection.setPublic() untuk menetapkan sesi Anda agar mengizinkan koneksi dari kontak yang tidak termasuk dalam daftar kontak BlackBerry Messenger Anda.

Untuk menerima pemberitahuan peristiwa dan perubahan pada sesi, Anda harus memperluas kelas BBMPlatformSessionListener dan mengabaikan metode panggilannya serta metode panggilan balik yang diperoleh dari kelas BBMPlatformConnectionListener.

Untuk membuat instance BBMPlatformSession, aktifkan MessagingService.createSession(), kirimkan referensi ke objek BBMPlatformSessionListener yang akan ditetapkan pada pengguna.

ContactListService

Kelas ContactListService menyediakan akses ke kontak yang ada dalam daftar kontak BlackBerry Messenger pengguna yang telah menginstal aplikasi.

Untuk menerima pemberitahuan tentang perubahan pada kontak dalam daftar kontak, Anda harus menerapkan antarmuka PresenceListener. PresenceListener mengandung sebuah metode panggilan balik, presenceUpdated(), yang akan dipanggil apabila salah satu kontak dalam daftar kontak Anda memperbarui gambar tampilannya, nama tampilan, pesan pribadi, atau status.

Untuk mengambil referensi ke ContactListService untuk aplikasi Anda, aktifkan BBMPlatformContext.getContactListService().

Untuk menetapkan PresenceListener pada daftar kontak Anda, aktifkan ContactListService.setListener(PresenceListener).

UIService

Kelas UIService menyediakan metode untuk menambahkan item menu yang spesifik untuk aplikasi itu ke BlackBerry Messenger, mengakses pemilih kontak yang memungkinkan pengguna memilih kontak berdasarkan sekumpulan kriteria yang dapat Anda tentukan, memungkinkan pengguna mengundang kontak yang tidak ada dalam daftar kontak BlackBerry Messenger pengguna ke BBM, atau memulai obrolan BlackBerry Messenger.

Untuk mengambil referensi ke UIService untuk aplikasi Anda, aktifkan BBMPlatformContext.getUIService().

MenuItemManager

Kelas MenuItemManager menyediakan metode untuk membuat, menambahkan, menghapus, dan memeriksa item menu pada layar daftar kontak BlackBerry Messenger. Item menu ini akan mengundang kontak yang dipilih untuk berinteraksi dengan pengguna menggunakan aplikasi Anda yang terhubung ke BlackBerry Messenger.

Item menu ini hanya ditampilkan jika kontak yang dipilih telah menginstal aplikasi.

Jika item menu untuk aplikasi Anda sudah ada, saat Anda menambahkan item menu baru, item yang ada akan ditimpa.


Apakah informasi ini berguna? Kirimkan komentar Anda kepada kami.