MTPush-API
MTCorePrivatesApi
- Digunakan terutama untuk konfigurasi informasi.
- Semua metode harus dipanggil di proses utama. Jangan melakukan pengecekan proses sebelum memanggil metode ini atau menempatkannya di proses anak, jika tidak akan terjadi kesalahan pemanggilan.
configAppKey
- Panggil di Application.onCreate()
- Panggil sebelum init
/**
* Mengonfigurasi application key tanpa perlu konfigurasi di AndroidManifest.xml
* Panggil di Application.onCreate()
* Panggil sebelum [init](#init)
*
* @param context tidak boleh null
* @param appKey tidak boleh null
*/
public static void configAppKey(Context context, String appKey)
/**
* Mengonfigurasi application key tanpa perlu konfigurasi di AndroidManifest.xml
* Panggil di Application.onCreate()
* Panggil sebelum [init](#init)
*
* @param context tidak boleh null
* @param appKey tidak boleh null
*/
public static void configAppKey(Context context, String appKey)
Tampilkan blok kode ini di jendela mengambang
Contoh kode:
MTCorePrivatesApi.configAppKey(this, "appkey_anda");
MTCorePrivatesApi.configAppKey(this, "appkey_anda");
Tampilkan blok kode ini di jendela mengambang
configAppChannel
- Panggil di Application.onCreate()
- Panggil sebelum init
/**
* Mengonfigurasi channel aplikasi tanpa perlu konfigurasi di AndroidManifest.xml
* Panggil di Application.onCreate()
* Panggil sebelum init
*
* @param context Tidak boleh null
* @param appChannel Tidak boleh null
*/
public static void configAppChannel(Context context, String appChannel)
/**
* Mengonfigurasi channel aplikasi tanpa perlu konfigurasi di AndroidManifest.xml
* Panggil di Application.onCreate()
* Panggil sebelum init
*
* @param context Tidak boleh null
* @param appChannel Tidak boleh null
*/
public static void configAppChannel(Context context, String appChannel)
Tampilkan blok kode ini di jendela mengambang
Contoh kode:
MTCorePrivatesApi.configAppChannel(this, "nama_channel_anda");
MTCorePrivatesApi.configAppChannel(this, "nama_channel_anda");
Tampilkan blok kode ini di jendela mengambang
configAppSiteName
- Panggil di Application.onCreate()
- Panggil sebelum init
/**
* Mengonfigurasi nama site data center tanpa perlu konfigurasi di AndroidManifest.xml
* Node yang tersedia: Singapore, USA_Virginia, DEU_Frankfurt, HongKong.
* Panggil di Application.onCreate()
* Panggil sebelum [init](#init)
*
* @param context tidak boleh null
* @param appSiteName tidak boleh null
*/
public static void configAppSiteName(Context context, String appSiteName)
/**
* Mengonfigurasi nama site data center tanpa perlu konfigurasi di AndroidManifest.xml
* Node yang tersedia: Singapore, USA_Virginia, DEU_Frankfurt, HongKong.
* Panggil di Application.onCreate()
* Panggil sebelum [init](#init)
*
* @param context tidak boleh null
* @param appSiteName tidak boleh null
*/
public static void configAppSiteName(Context context, String appSiteName)
Tampilkan blok kode ini di jendela mengambang
Contoh kode:
MTCorePrivatesApi.configAppSiteName(this, "NamaSiteDataCenter");
MTCorePrivatesApi.configAppSiteName(this, "NamaSiteDataCenter");
Tampilkan blok kode ini di jendela mengambang
configHeartbeatInterval
- Panggil di Application.onCreate()
- Panggil sebelum init
/**
* Mengatur interval heartbeat
* Panggil di Application.onCreate()
*
* @param context tidak boleh null
* @param heartbeatInterval Dalam milidetik, >0, default 4 menit 50 detik
*/
public static void configHeartbeatInterval(Context context, long heartbeatInterval)
/**
* Mengatur interval heartbeat
* Panggil di Application.onCreate()
*
* @param context tidak boleh null
* @param heartbeatInterval Dalam milidetik, >0, default 4 menit 50 detik
*/
public static void configHeartbeatInterval(Context context, long heartbeatInterval)
Tampilkan blok kode ini di jendela mengambang
Contoh kode (interval 3 menit):
MTCorePrivatesApi.configHeartbeatInterval(this, 3*60*1000);
MTCorePrivatesApi.configHeartbeatInterval(this, 3*60*1000);
Tampilkan blok kode ini di jendela mengambang
configConnectRetryCount
- Panggil di Application.onCreate()
- Panggil sebelum init
/**
* Mengatur jumlah retry koneksi panjang
* Panggil di Application.onCreate()
*
* @param context tidak boleh null
* @param connectRetryCount Default 3, minimal 3
*/
public static void configConnectRetryCount(Context context, int connectRetryCount)
/**
* Mengatur jumlah retry koneksi panjang
* Panggil di Application.onCreate()
*
* @param context tidak boleh null
* @param connectRetryCount Default 3, minimal 3
*/
public static void configConnectRetryCount(Context context, int connectRetryCount)
Tampilkan blok kode ini di jendela mengambang
Contoh kode (retry 10 kali):
MTCorePrivatesApi.configConnectRetryCount(this, 10);
MTCorePrivatesApi.configConnectRetryCount(this, 10);
Tampilkan blok kode ini di jendela mengambang
setTcpSSl
- Panggil di Application.onCreate()
- Panggil sebelum init
/**
* Mengatur apakah koneksi panjang dienkripsi, default tidak
* Panggil di Application.onCreate()
*
* @param isSSL true untuk enkripsi, false untuk tidak
*/
public static void setTcpSSl(boolean isSSL)
/**
* Mengatur apakah koneksi panjang dienkripsi, default tidak
* Panggil di Application.onCreate()
*
* @param isSSL true untuk enkripsi, false untuk tidak
*/
public static void setTcpSSl(boolean isSSL)
Tampilkan blok kode ini di jendela mengambang
Contoh kode (aktifkan enkripsi):
MTCorePrivatesApi.setTcpSSl(true);
MTCorePrivatesApi.setTcpSSl(true);
Tampilkan blok kode ini di jendela mengambang
configDebugMode
- Panggil di Application.onCreate()
- Panggil sebelum init
- Format log EngageLab, cari "ENGAGELAB-PRIVATES"
- Log dipisah antara proses utama dan proses anak
/**
* Mengatur mode debug, akan mencetak log lebih detail
* Panggil di Application.onCreate()
*
* @param context tidak boleh null
* @param enable true untuk debug, false untuk tidak
*/
public static void configDebugMode(Context context, boolean enable)
/**
* Mengatur mode debug, akan mencetak log lebih detail
* Panggil di Application.onCreate()
*
* @param context tidak boleh null
* @param enable true untuk debug, false untuk tidak
*/
public static void configDebugMode(Context context, boolean enable)
Tampilkan blok kode ini di jendela mengambang
Contoh kode:
// Disarankan true saat pengembangan
MTCorePrivatesApi.configDebugMode(context.getApplicationContext(), true);
// Disarankan false saat rilis
MTCorePrivatesApi.configDebugMode(context.getApplicationContext(), false);
// Disarankan true saat pengembangan
MTCorePrivatesApi.configDebugMode(context.getApplicationContext(), true);
// Disarankan false saat rilis
MTCorePrivatesApi.configDebugMode(context.getApplicationContext(), false);
Tampilkan blok kode ini di jendela mengambang
configSM4
- Panggil di Application.onCreate()
- Panggil sebelum init
/**
* Konfigurasi enkripsi standar nasional
* @param context tidak boleh null
*/
public static void configSM4(Context context)
/**
* Konfigurasi enkripsi standar nasional
* @param context tidak boleh null
*/
public static void configSM4(Context context)
Tampilkan blok kode ini di jendela mengambang
Contoh kode:
MTCorePrivatesApi.configSM4(context.getApplicationContext());
MTCorePrivatesApi.configSM4(context.getApplicationContext());
Tampilkan blok kode ini di jendela mengambang
getUserId
Jika hasil kosong, cek apakah sudah konfigurasi dan inisialisasi Jika sudah benar, mungkin masih proses koneksi, cek saat onConnectStatus true
/**
* Mendapatkan userId perangkat saat ini, pengenal unik EngageLab
* @param context tidak boleh null
* @return userId
*/
public static String getUserId(Context context)
/**
* Mendapatkan userId perangkat saat ini, pengenal unik EngageLab
* @param context tidak boleh null
* @return userId
*/
public static String getUserId(Context context)
Tampilkan blok kode ini di jendela mengambang
Contoh kode:
String userId = MTCorePrivatesApi.getUserId(context);
String userId = MTCorePrivatesApi.getUserId(context);
Tampilkan blok kode ini di jendela mengambang
getRegistrationId
Jika hasil kosong, cek apakah sudah konfigurasi dan inisialisasi Jika sudah benar, mungkin masih proses koneksi, cek saat onConnectStatus true
/**
* Mendapatkan registrationId perangkat saat ini, pengenal unik EngageLab
* @param context tidak boleh null
* @return registrationId
*/
public static String getRegistrationId(Context context)
/**
* Mendapatkan registrationId perangkat saat ini, pengenal unik EngageLab
* @param context tidak boleh null
* @return registrationId
*/
public static String getRegistrationId(Context context)
Tampilkan blok kode ini di jendela mengambang
Contoh kode:
String registrationId = MTCorePrivatesApi.getRegistrationId(context);
String registrationId = MTCorePrivatesApi.getRegistrationId(context);
Tampilkan blok kode ini di jendela mengambang
setEnableResetOnDeviceChange
- Panggil di Application.onCreate()
- Panggil sebelum init
- Default false (nonaktif)
/**
* Konfigurasi migrasi perangkat
* Jika aktif, saat model perangkat berubah, registration ID dan UID lokal akan dihapus & didaftarkan ulang
* Default false
*
* @param context Tidak boleh null
* @param enable true aktif, false nonaktif
*/
public static void setEnableResetOnDeviceChange(Context context, boolean enable)
/**
* Konfigurasi migrasi perangkat
* Jika aktif, saat model perangkat berubah, registration ID dan UID lokal akan dihapus & didaftarkan ulang
* Default false
*
* @param context Tidak boleh null
* @param enable true aktif, false nonaktif
*/
public static void setEnableResetOnDeviceChange(Context context, boolean enable)
Tampilkan blok kode ini di jendela mengambang
Contoh kode:
MTCorePrivatesApi.setEnableResetOnDeviceChange(this, true); // aktifkan
MTCorePrivatesApi.setEnableResetOnDeviceChange(this, false); // nonaktif (default)
MTCorePrivatesApi.setEnableResetOnDeviceChange(this, true); // aktifkan
MTCorePrivatesApi.setEnableResetOnDeviceChange(this, false); // nonaktif (default)
Tampilkan blok kode ini di jendela mengambang
MTPushPrivatesApi
- Digunakan untuk fungsi push
- Semua metode harus dipanggil di proses utama, jangan cek proses sebelum memanggil atau menempatkan di proses anak, jika tidak akan error
configOldPushVersion
- Jika backend belum upgrade ke versi
tag: V3.5.4-newportal-20210823-gamma.57, frontend wajib memanggil ini, jika tidak klik notifikasi bisa bermasalah- Panggil di Application.onCreate()
- Panggil sebelum init
/**
* Konfigurasi versi push ke 3.9.X
* @param context tidak boleh null
*/
public static void configOldPushVersion(Context context)
/**
* Konfigurasi versi push ke 3.9.X
* @param context tidak boleh null
*/
public static void configOldPushVersion(Context context)
Tampilkan blok kode ini di jendela mengambang
Contoh kode:
MTPushPrivatesApi.configOldPushVersion(context.getApplicationContext());
MTPushPrivatesApi.configOldPushVersion(context.getApplicationContext());
Tampilkan blok kode ini di jendela mengambang
setEnablePushTextToSpeech
/**
* Pengaturan fitur siaran suara, perlu impor paket suara (mt-sdk-sound-x.x.x.aar)
* @param context Tidak boleh null
* @param enable true aktif, false nonaktif, default false
*/
public static void setEnablePushTextToSpeech(Context context, boolean enable)
/**
* Pengaturan fitur siaran suara, perlu impor paket suara (mt-sdk-sound-x.x.x.aar)
* @param context Tidak boleh null
* @param enable true aktif, false nonaktif, default false
*/
public static void setEnablePushTextToSpeech(Context context, boolean enable)
Tampilkan blok kode ini di jendela mengambang
Contoh kode:
MTPushPrivatesApi.setEnablePushTextToSpeech(context, true);
MTPushPrivatesApi.setEnablePushTextToSpeech(context, true);
Tampilkan blok kode ini di jendela mengambang
init
- Disarankan dipanggil di Application.onCreate()
/**
* Inisialisasi MTPush
* Disarankan di Application.onCreate()
* @param context tidak boleh null, gunakan applicationContext
*/
public static void init(Context context)
/**
* Inisialisasi MTPush
* Disarankan di Application.onCreate()
* @param context tidak boleh null, gunakan applicationContext
*/
public static void init(Context context)
Tampilkan blok kode ini di jendela mengambang
Contoh kode:
MTPushPrivatesApi.init(context.getApplicationContext());
MTPushPrivatesApi.init(context.getApplicationContext());
Tampilkan blok kode ini di jendela mengambang
setCollectControl
- Atur kontrol pengumpulan data
- Disarankan dipanggil di Application.onCreate(), sebelum init
/**
* Atur kontrol pengumpulan data
* Kontrol apakah data tertentu dikumpulkan dari perangkat
* Disarankan di Application.onCreate(), sebelum init
* @param control Objek kontrol, tidak boleh null
*/
public static void setCollectControl(MTPushCollectControl control)
/**
* Atur kontrol pengumpulan data
* Kontrol apakah data tertentu dikumpulkan dari perangkat
* Disarankan di Application.onCreate(), sebelum init
* @param control Objek kontrol, tidak boleh null
*/
public static void setCollectControl(MTPushCollectControl control)
Tampilkan blok kode ini di jendela mengambang
Contoh kode:
MTPushCollectControl collectControl = new MTPushCollectControl();
collectControl.setGaid(true); // true aktif, false nonaktif. Default aktif.
MTPushPrivatesApi.setCollectControl(collectControl);
MTPushCollectControl collectControl = new MTPushCollectControl();
collectControl.setGaid(true); // true aktif, false nonaktif. Default aktif.
MTPushPrivatesApi.setCollectControl(collectControl);
Tampilkan blok kode ini di jendela mengambang
goToAppNotificationSettings
- Setelah SDK berjalan, Anda bisa menerima callback hasil pada onNotificationStatus, lalu putuskan perlu/tidaknya memanggil metode ini
/**
* Masuk ke pengaturan notifikasi aplikasi
* @param context tidak boleh null
*/
public static void goToAppNotificationSettings(Context context)
/**
* Masuk ke pengaturan notifikasi aplikasi
* @param context tidak boleh null
*/
public static void goToAppNotificationSettings(Context context)
Tampilkan blok kode ini di jendela mengambang
Contoh kode:
MTPushPrivatesApi.goToAppNotificationSettings(this);
MTPushPrivatesApi.goToAppNotificationSettings(this);
Tampilkan blok kode ini di jendela mengambang
turnOnPush
- Umumnya untuk mengaktifkan push setelah turnOffPush
- Pemanggilan berulang hanya berlaku sekali
- Jika lingkungan tidak bermasalah, onConnectStatus akan mengembalikan hasil
- Channel didukung: Engagelab/Huawei/Xiaomi/Meizu/oppo/vivo
/**
* Aktifkan Push, status disimpan persisten true, default true
* @param context tidak boleh null
*/
public static void turnOnPush(Context context)
/**
* Aktifkan Push, status disimpan persisten true, default true
* @param context tidak boleh null
*/
public static void turnOnPush(Context context)
Tampilkan blok kode ini di jendela mengambang
Contoh kode:
MTPushPrivatesApi.turnOnPush(context);
MTPushPrivatesApi.turnOnPush(context);
Tampilkan blok kode ini di jendela mengambang
turnOffPush
- Umumnya untuk menonaktifkan push
- Setelah dinonaktifkan, panggilan init tidak akan mengaktifkan push
- Pemanggilan berulang hanya berlaku sekali
- Jika lingkungan tidak bermasalah, onConnectStatus akan mengembalikan hasil
- Channel didukung: Engagelab/Huawei/Xiaomi/Meizu/oppo/vivo
/**
* Nonaktifkan push, status disimpan persisten false, default true
* @param context tidak boleh null
*/
public static void turnOffPush(Context context)
/**
* Nonaktifkan push, status disimpan persisten false, default true
* @param context tidak boleh null
*/
public static void turnOffPush(Context context)
Tampilkan blok kode ini di jendela mengambang
Contoh kode:
MTPushPrivatesApi.turnOffPush(context);
MTPushPrivatesApi.turnOffPush(context);
Tampilkan blok kode ini di jendela mengambang
addTag, deleteTag, updateTag, queryTag, deleteAllTag, queryAllTag, setAlias, getAlias, clearAlias
- Lihat detail dan contoh kode pada dokumen utama di atas.
setNotificationShowTime, resetNotificationShowTime, setNotificationSilenceTime, resetNotificationSilenceTime, setNotificationLayout, resetNotificationLayout, setNotificationCount, resetNotificationCount, setNotificationBadge, resetNotificationBadge, showNotification, clearNotification
- Lihat detail dan contoh kode pada dokumen utama di atas.
reportNotificationArrived, reportNotificationClicked, reportNotificationDeleted, reportNotificationOpened, uploadPlatformToken, clearPlatformToken
- Lihat detail dan contoh kode pada dokumen utama di atas.
onFragmentResume, onFragmentPause
- Lihat detail dan contoh kode pada dokumen utama di atas.










