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ính | Kiểu dữ liệu | Bắt buộc | Mô tả |
|---|---|---|---|
| success | Function | Callback function khi thành công. Nhận object chứa thông tin liên hệ. | |
| fail | Function | Callback function khi thất bại. | |
| complete | Function | Callback 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ính | Kiểu dữ liệu | Mô tả |
|---|---|---|
| full_name | String | Tên hiển thị của liên hệ |
| phone_number | String | Số đ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
failsẽ được gọi