openMediaPicker

Cập nhật lần cuối: 27/05/2022

Bắt đầu hỗ trợ ở phiên bản:
API: 2.18.11

Lưu ý

Với API version ﹤ 2.23.0, phải gọi api login trước khi gọi api này và cần xin cấp quyền tại trang Quản lý ứng dụng

Mở cửa sổ chọn media (ảnh, file, video) từ thiết bị. Media sau khi chọn sẽ được tải lên server của bạn dưới dạng dữ liệu multipart/form-data, fieldname=file.

Parameters

Object object

Property	Type	Default	Required	Description
type	string		true	Nhận các giá trị sau: 'photo': Mở cửa sổ chọn ảnh 'file': Mở của sổ chọn file 'video': Mở của sổ chọn video
serverUploadUrl	string		true	Đường dẫn upload media
maxItemSize	number			Giới hạn kích thước (byte) tối đa của media được phép chọn
maxSelectItem	number	1		Giới hạn số lượng tối đa media được chọn
silentRequest	boolean	false		Nhận các giá trị sau: false: Hiện dialog xử lý các tác vụ ngầm như (render video, upload media,...) và có nút hủy tác vụ true: không hiện dialog xử lý các tác vụ ngầm media
editView	object			Hiển thị view chỉnh sửa ảnh
success	function			Callback function khi gọi api thành công
fail	function			Callback function khi gọi api thất bại

Object editView

Property	Type	Default	Required	Description	Minimum Version
enable	boolean	true	true	Hiển thị view chỉnh sửa ảnh
aspectRatio	string	1:1		Cắt ảnh theo tỉ lệ đã chỉ định. Tỉ lệ truyền vào theo format `width:height`: là phân số tối giản qui định tỉ lệ width/height

Return Values

Promise<Object res>

Property	Type	Description	Minimum Version
data	string	Toàn bộ nội dung trả về của server upload media

Sample Code

import api from 'zmp-sdk';

api.openMediaPicker({
  type: 'photo',
  serverUploadUrl: '',
  success: (res) => {
    // xử lý khi gọi api thành công
    const { data } = res;
    const result = JSON.parse(data);
    console.log(result);
  },
  fail: (error) => {
    // xử lý khi gọi api thất bại
    console.log(error);
  }
});

// hoặc
const test = async () => {
  try {
    const { result_content } = await api.openMediaPicker({
      type: 'photo',
      serverUploadUrl: ''
    });
    const result = JSON.parse(result_content);
    console.log(result);
  } catch (error) {
    // xử lý khi gọi api thất bại
    console.log(error);
  }
};

Errors

Bắt đầu hỗ trợ:
API phiên bản: 2.21.0

Code	Message	Note
-2003	User cancel
-2004	Unable to pick media	Hãy kiểm tra lại tình trạng mạng hoặc server upload

Parameters​

Object object​

Object editView​

Return Values​

Promise<Object res>​

Sample Code​

Errors​