Mobile Platform as a Service:Client APIs

Kelas MPPush pada lapisan tengah mPaaS mengenkapsulasi seluruh API komponen Mobile Push Service, seperti bind, unbind, dan pelaporan perangkat saluran pihak ketiga. SDK mobile gateway mengimplementasikan remote procedure calls (RPCs) untuk metode API tersebut.

Bind

• Definisi metode

  Metode ini menautkan user ID ke device ID. Setelah ditautkan, Anda dapat mendorong pesan ke pengguna tertentu. Panggil metode ini dalam subthread.

    public static ResultPbPB bind(Context ctx, String userId, String token)

• Parameter

  Parameter	Tipe	Deskripsi
  ctx	Context	Context yang tidak kosong.
  userId	String	Identifikasi unik pengguna. Identifier ini tidak harus merupakan ID aktual dari sistem pengguna Anda, tetapi harus memiliki pemetaan satu-ke-satu terhadap pengguna.
  token	String	Device ID yang dikeluarkan oleh gerbang Mobile Push Service.

• Nilai kembalian

  Parameter	Deskripsi
  success	Menunjukkan apakah pemanggilan API berhasil. true: Pemanggilan berhasil. false: Pemanggilan gagal.
  code	Kode hasil operasi. Untuk kode hasil umum beserta deskripsinya, lihat tabel berikut.
  name	Nama kode hasil operasi.
  message	Deskripsi kode hasil operasi.

  Deskripsi kode hasil

  Kode hasil	Nama kode hasil	Pesan	Deskripsi
  3012	NEED_USERID	need userid	Parameter input userId kosong.
  3001	NEED_DELIVERYTOKEN	need token	Parameter input token kosong.

• Contoh

    private void doSimpleBind() {
        final ResultPbPB resultPbPB = MPPush.bind(getApplicationContext(), mUserId, PushMsgService.mAdToken);
        handlePbPBResult("Bind user operation", resultPbPB);
    }

Unbind

• Definisi metode

  Metode ini melepaskan tautan antara user ID dan device ID. Panggil metode ini dalam subthread.

  public static ResultPbPB unbind(Context ctx, String userId, String token)

• Parameter

  Parameter	Tipe	Deskripsi
  ctx	Context	Context yang tidak kosong.
  userId	String	Identifikasi unik pengguna. Identifier ini tidak harus merupakan ID aktual dari sistem pengguna Anda, tetapi harus memiliki pemetaan satu-ke-satu terhadap pengguna.
  token	String	Device ID yang dikeluarkan oleh gerbang Mobile Push Service.

• Nilai kembalian

  Metode ini mengembalikan nilai yang sama dengan metode bind.

• Contoh

    private void doSimpleUnBind() {
        final ResultPbPB resultPbPB = MPPush.unbind(getApplicationContext()
                , mUserId, PushMsgService.mAdToken);
        handlePbPBResult("Unbind user operation", resultPbPB);
    }

Report third-party channel device

• Definisi metode

  Metode ini melaporkan device ID saluran pihak ketiga dan device ID mPaaS (Ad-token yang dikeluarkan oleh gerbang Mobile Push Service) ke inti Mobile Push Service. Inti Mobile Push Service kemudian secara sinkron menautkan kedua identifier tersebut. Setelah penautan selesai, Anda dapat mendorong pesan melalui saluran pihak ketiga.

  Kerangka kerja memanggil metode ini secara internal. Untuk mencegah potensi kegagalan panggilan SDK, Anda harus memanggil metode ini kembali secara manual.

    public static ResultPbPB report(Context context, String deliveryToken, int thirdChannel, String thirdChannelDeviceToken)

• Parameter

  Parameter	Tipe	Deskripsi
  ctx	Context	Context yang tidak kosong.
  deliveryToken	String	Device ID (Ad-token) yang dikeluarkan oleh gerbang Mobile Push Service.
  thirdChannel	int	Saluran pihak ketiga. Nilai enumerasi sebagai berikut: 2: Apple 4: Xiaomi 5: Huawei 6: FCM 7: OPPO 8: vivo
  thirdChannelDeviceToken	String	Device ID saluran vendor

• Nilai kembalian

  Metode ini mengembalikan nilai yang sama dengan metode bind.

• Contoh

    private void doSimpleUploadToken() {
        final ResultPbPB resultPbPB = MPPush.report(getApplicationContext(), PushMsgService.mAdToken
                , PushOsType.HUAWEI.value(), PushMsgService.mThirdToken);
        handlePbPBResult("Third-party push identifier reporting operation", resultPbPB);

Pemecahan Masalah

Jika terjadi exception selama pemanggilan resource RPC, lihat Deskripsi kode hasil Security Guard untuk memecahkan masalah tersebut.