SuperApp：Buku Alamat

WVContacts.askAuth

Meminta akses ke buku alamat.

Parameter input

Tidak ada parameter input yang diperlukan.

Parameter callback

Parameter callback dilewatkan ke metode callback. Jika versi iOS yang digunakan lebih lama dari iOS 6, Anda tidak perlu meminta akses ke buku alamat dan tidak ada callback yang dipanggil. Jika versi iOS yang digunakan adalah iOS 6 atau lebih baru, success callback selalu dipanggil.

• [int]isAuthed: menunjukkan apakah aplikasi dapat mengakses buku alamat. Nilai valid: 0 dan 1.

window.WindVane.call('WVContacts', 'askAuth', {}, function(e) {
        alert(JSON.stringify(e));
});

WVContacts.authStatus

Mendapatkan status akses saat ini untuk buku alamat.

Parameter input

Tidak ada parameter input yang diperlukan.

Parameter callback

Parameter callback dilewatkan ke metode callback. API ini selalu memanggil success callback.

• [boolean]isAuthed: menunjukkan apakah aplikasi dapat mengakses buku alamat. Nilai valid: 0 dan 1.

• [int]status: status akses spesifik. Parameter ini hanya tersedia di WindVane iOS. Nilai valid:

  • 0: Not Determined.

  • 1: Restricted.

  • 2: Denied.

  • 3: Authorized.

window.WindVane.call('WVContacts', 'authStatus', {}, function(e) {
        alert(JSON.stringify(e));
});

WVContacts.choose

Menampilkan kontak di buku alamat. Setelah pengguna memilih kontak, nama dan nomor telepon kontak dikembalikan ke halaman HTML5 terkait.

Parameter input

Tidak ada parameter input yang diperlukan.

Parameter callback

Parameter callback dilewatkan ke metode callback. Jika pengguna memilih kontak, success callback dipanggil. Sebaliknya, failure callback dipanggil.

• [string]name: nama kontak yang dipilih.

• [string]phone: nomor telepon kontak yang dipilih.

window.WindVane.call('WVContacts', 'choose', {}, function(e) {
        alert('success: ' + JSON.stringify(e));
}, function(e) {
        alert('failure: ' + JSON.stringify(e))
});

WVContacts.find

Mencari kontak di buku alamat berdasarkan nama dan nomor telepon yang ditentukan.

Parameter input

• [object]filter: filter kontak. Filter tersebut berisi properti-properti berikut:

  • [string]name: nama kontak yang dicari.

  • [string]phone: nomor telepon kontak yang dicari.

Jika baik phone maupun name dikonfigurasi, kontak yang memenuhi kedua kondisi filter akan dikembalikan. Jika sebuah kontak memiliki beberapa nomor telepon, beberapa catatan akan ditampilkan dalam daftar hasil.

Parameter callback

Parameter callback dilewatkan ke metode callback. API ini selalu memanggil success callback.

• [array]contacts: daftar kontak yang memenuhi kondisi filter. Setiap item dalam array berisi properti-properti berikut:

  • [string]name: nama kontak yang memenuhi kondisi filter.

  • [string]phone: nomor telepon kontak yang memenuhi kondisi filter.

var params = {
        // Filter kontak.
        filter: {
                // Cari kontak dengan nama tertentu.
                name: 'Jack',
                // Cari kontak dengan nomor telepon tertentu.
                phone: '123456'
        }
}
window.WindVane.call('WVContacts', 'find', params, function(e) {
        alert(JSON.stringify(e));
});

WVContacts.addPhoneContact

Menambahkan kontak.

Parameter input

• [string]lastName: nama belakang kontak.

• [string]firstName: nama depan kontak.

• [string]middleName: nama tengah kontak. Parameter ini opsional.

• [string]nickName: nama panggilan kontak. Parameter ini opsional.

• [string]remark: catatan. Parameter ini opsional.

• [string]mobilePhoneNumber: nomor telepon kontak. Parameter ini opsional.

• [string]hostNumber: nomor telepon kantor atau rumah kontak. Parameter ini opsional.

• [string]address: alamat kontak. Parameter ini opsional.

• [string]email: email kontak. Parameter ini opsional.

• [string]organization: organisasi kontak. Parameter ini opsional.

• [string]title: jabatan kontak. Parameter ini opsional.

• [string]photoPath: jalur lokal foto profil. Parameter ini opsional.

Parameter callback

Parameter untuk callback sukses:

• Tidak ada parameter callback yang diperlukan.

Parameter untuk callback gagal:

• [string]msg: pesan kesalahan.

var params = {
  lastName: 'xxx',
  firstName: 'xxx',
  middleName:'xxx',
  nickName: 'xxx',
  remark: 'xxx',
  mobilePhoneNumber: '+86 12345',
  hostNumber: '12345',
  address: 'Beijing Chaoyang',
  email: 'xxx@xxx.com',
  organization: 'xxx',
  title: 'xxx',
  photoPath: '/storage/emulated/0/DCIM/Camera/xxx.jpg
}

window.WindVane.call('WVContacts', 'addPhoneContact', {}, function(e) {
}, function(e) {
        alert('failure: ' + JSON.stringify(e))
});