Mobile Platform as a Service:Android API

Pada baseline 10.1.32 dan versi selanjutnya, kelas MPSync di lapisan tengah mPaaS mengenkapsulasi semua operasi API untuk komponen sinkronisasi mobile. Objek MPSync menyediakan semua fitur MSS.

java.lang.Object
  - com.mpaas.mss.adapter.api.MPSync

Berikut adalah fungsi publiknya:

setup(Application application)

Deklarasi

public static void setup(Application application)

Deskripsi

Menginisialisasi layanan dasar yang dibutuhkan oleh layanan sinkronisasi mobile. Panggil metode ini sebelum memanggil metode initialize. Metode ini hanya tersedia pada baseline 10.1.60 dan versi yang lebih baru.

Parameter

Nilai kembalian

Tidak ada.

appToBackground()

Deklarasi

public static void appToBackground()

Deskripsi

Panggil metode ini setiap kali aplikasi masuk ke background. Hal ini memberi tahu client SDK dan memutus koneksi aplikasi dari server.

Panggil metode ini di dalam metode onStop() halaman utama. Jika Anda tidak memanggil operasi API ini saat aplikasi berpindah ke background, koneksi jaringan akan tetap aktif dalam waktu lama, sehingga meningkatkan konsumsi daya dan penggunaan data.

Parameter

Tidak ada.

Nilai kembalian

Tidak ada.

appToForeground()

Deklarasi

public static void appToForeground()

Deskripsi

Metode ini memberi tahu client SDK bahwa aplikasi telah dimulai, yang kemudian membangun koneksi jaringan dengan server. Panggil metode ini setiap kali aplikasi berpindah ke foreground.

Anda dapat memanggil metode ini di dalam metode onResume() halaman utama.

Parameter

Tidak ada.

Nilai kembalian

Tidak ada.

clearUserInfo()

Deklarasi

public static void clearUserInfo()

Deskripsi

Logout pengguna.

Parameter

Tidak ada.

Nilai kembalian

Tidak ada.

initialize(Context context)

Deklarasi

public static void initialize(Context ctx)

Deskripsi

Menginisialisasi layanan sinkronisasi mobile. Metode ini harus dipanggil sebelum aplikasi dapat menggunakan layanan tersebut.

Panggil metode ini hanya sekali per siklus hidup aplikasi.

Parameter

Nilai kembalian

Tidak ada.

isConnected()

Deklarasi

public static boolean isConnected()

Deskripsi

Memverifikasi apakah layanan sinkronisasi mobile terhubung.

Parameter

Tidak ada.

Nilai kembalian

Mengembalikan true jika berhasil atau false jika gagal.

registerBiz(String bizType, ISyncCallback syncCallback)

Deklarasi

public static void registerBiz(String biz, ISyncCallback callback)

Deskripsi

Mendaftarkan callback untuk menerima data bisnis. Client SDK memanggil kelas implementasi syncCallback setelah menerima data yang disinkronkan.

Anda dapat memanggil operasi API ini untuk setiap konfigurasi sinkronisasi.

Parameter

Nilai kembalian

Tidak ada.

reportMsgReceived(SyncMessage syncMessag)

Deklarasi

public static void reportMsgReceived(SyncMessage msg)

Deskripsi

Setelah Anda menerima data yang didorong di dalam metode syncCallback, panggil metode ini untuk memberi tahu server sinkronisasi mobile bahwa data telah berhasil diterima. Jika server tidak menerima notifikasi reportMsgReceived, server akan mencoba mengirimkan ulang data tersebut. Setelah enam kali percobaan, data tersebut akan dihapus secara permanen.

Parameter

Nilai kembalian

Tidak ada.

unregisterBiz(String bizType)

Deklarasi

public static void unregisterBiz(String biz)

Deskripsi

Membatalkan pendaftaran konfigurasi sinkronisasi tertentu. Setelah konfigurasi dibatalkan pendaftarannya, layanan sinkronisasi mobile tidak lagi memanggil syncCallback ketika menerima data untuk konfigurasi tersebut.

Parameter

Nilai kembalian

Tidak ada.

updateUserInfo(String sessionId)

Deklarasi

public static boolean updateUserInfo(String sessionId)

Deskripsi

Metode ini secara internal memanggil metode LongLinkSyncService.getInstance().updateUserInfo(String userId, String sessionId). userId adalah ID pengguna yang ditetapkan di MPLogger. Anda harus memanggil metode ini untuk memperbarui informasi login pengguna setiap kali userId atau sessionId berubah, sesi berakhir, atau login otomatis berhasil. Saat memanggil metode ini, kedua parameter tidak boleh kosong. Jika userId tidak ditetapkan, metode ini mengembalikan false dan pemanggilan gagal.

Parameter

Nilai kembalian

Mengembalikan true jika informasi pengguna berhasil diperbarui, atau false jika userId tidak ditetapkan saat login.