Chuyển tới nội dung chính

choosePhoneContact

choosePhoneContact là API dùng để mở danh bạ thiết bị và cho phép người dùng chọn một số điện thoại.

Khả dụng:

Runtime version: 1.0.1

Ví dụ

Chọn số điện thoại từ danh bạ

import apis from '@v-miniapp/apis'

apis.choosePhoneContact({
success: res => {
console.log('Đã chọn liên hệ:', res)
console.log('Tên:', res.full_name)
console.log('Số điện thoại:', res.phone_number)
},
fail: err => {},
})

Tham số

Thuộc tínhKiểu dữ liệuBắt buộcMô tả
successFunctionCallback function khi thành công. Nhận object chứa thông tin liên hệ.
failFunctionCallback function khi thất bại.
completeFunctionCallback function khi hoàn tất tác vụ cho dù thành công hay thất bại.

Success Response

Object trả về trong callback success chứa các thuộc tính:

Thuộc tínhKiểu dữ liệuMô tả
full_nameStringTên hiển thị của liên hệ
phone_numberStringSố điện thoại được chọn

Lưu ý

  • Người dùng cần cấp quyền truy cập danh bạ cho ứng dụng khi sử dụng API này lần đầu
  • API sẽ mở giao diện danh bạ của hệ thống để người dùng chọn
  • Nếu người dùng hủy chọn liên hệ, callback fail sẽ được gọi