Nhảy tới nội dung

openShareSheet

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

  • SDK: 2.5.3
Lưu ý

Cần xin cấp quyền tại trang Quản lý ứng dụng

Cho phép ứng dụng mở giao diện chia sẻ để người dùng chia sẻ thông tin với bạn bè Zalo.

Parameters​

Object object​

PropertyTypeDefaultRequiredDescriptionMinimum Version
typestringtrueNhận các giá trị sau:
  • 'image': Chia sẻ hình ảnh
  • 'link': Chia sẻ liên kết
  • 'oa': Chia sẻ OA
  • 'gif': Chia sẻ ảnh động
  • 'video': Chia sẻ video
  • 'zmp': Chia sẻ page hiện tại của Zalo Mini App
  • 'zmp_deep_link': Chia sẻ page hiện tại của Zalo Mini App thông qua deep link để có thể truy cập Mini App từ ngoài ứng dụng Zalo
Type: 'zmp_deep_link' sẽ được hỗ trợ từ API: 2.25.7
dataobjecttrueNội dung cần chia sẻ
successfunctionCallback function khi gọi api thành công
failfunctionCallback function khi gọi api thất bại n

Object data​

Chia sẻ văn bản (type='text')​
PropertyTypeDefaultRequiredDescriptionMinimum Version
textstringtrueNội dung văn bản cần chia sẻ2.39.0
descriptionstringMô tả thêm cho nội dung cần chia sẻ2.39.1
autoParseLinkbooleanfalseVới giá trị 'true' url trong text sẽ được hiển thị dưới dạng thumbnail2.39.0
Chia sẻ hình ảnh (type='image')​
PropertyTypeDefaultRequiredDescriptionMinimum Version
imageUrlsstring[]trueUrl của các hình ảnh cần chia sẻ
PropertyTypeDefaultRequiredDescriptionMinimum Version
linkstringtrueLiên kết cần chia sẻ
chatOnlybooleantrueChỉ chia sẻ qua cửa sổ chat
Chia sẻ Official Account (type='oa')​
PropertyTypeDefaultRequiredDescriptionMinimum Version
idstringtrueId của official account
Chia sẻ ảnh động (type='gif')​
PropertyTypeDefaultRequiredDescriptionMinimum Version
gifUrlstringtrueUrl ảnh động cần chia sẻ
imageUrlstringUrl hình ảnh đại diện
widthnumberChiều rộng
heightnumberChiều cao
Chia sẻ video (type='video')​
PropertyTypeDefaultRequiredDescriptionMinimum Version
videoThumbstringtrueUrl thumbnail cho video
videoUrlstringtrueUrl video
widthnumberChiều rộng
heightnumberChiều cao
Chia sẻ page hiện tại của Zalo Mini App (type='zmp')​
PropertyTypeDefaultRequiredDescriptionMinimum Version
titlestringtrueTiêu đề cần chia sẻ
descriptionstringMô tả
thumbnailstringtrueUrl thumbnail cho Zalo Mini App
pathstringtrueĐường dẫn cần chia sẻ
Chia sẻ page hiện tại của Zalo Mini App thông qua deep link (type='zmp_deep_link')​
PropertyTypeDefaultRequiredDescriptionMinimum Version
titlestringtrueTiêu đề cần chia sẻ. Tối đa 100 ký tự
thumbnailstringtrueUrl thumbnail cho Zalo Mini App
descriptionstringMô tả. Tối đa 400 ký tự
pathstringĐường dẫn cần chia sẻ, mặc định sẽ lấy theo đường dẫn hiện tại

Return Values​

Promise <Object data>​

PropertyTypeDescriptionMinimum Version
statusnumberCó các giá trị sau:
  • 0: User nhấn huỷ/cancel bài viết
  • 1: Đăng bài viết thành công lên nhật ký
  • 2: Đăng bài viết thành công qua cửa sổ chat
shareTypenumberTrạng thái bài chia sẻ, có các giá trị sau:
  • 0: Công khai
  • 1: Chỉ mình tôi
  • 2: Chia sẻ cho danh sách bạn
numberOfUsernumberSố lượng user nhận được bài chia sẻ trong trường hợp shareType=2

Sample Code​

Chia sẻ hình ảnh​

import { openShareSheet } from "zmp-sdk/apis";

openShareSheet({
  type: "image",
  data: {
    imageUrls: ["http://dev.org.zads.zdn.vn/2a16c7fefbbb12e54baa"]
  },
  success: (data) => {},
  fail: (err) => {}
});

Hoặc

import { openShareSheet } from "zmp-sdk/apis";

const shareImage = async () => {
  try {
    const data = await openShareSheet({
      type: "image",
      data: {
        imageUrls: ["http://dev.org.zads.zdn.vn/2a16c7fefbbb12e54baa"]
      }
    });
  } catch (err) {}
};

Chia sẻ liên kết​

import { openShareSheet } from "zmp-sdk/apis";

openShareSheet({
  type: "link",
  data: {
    link: "http://news.zing.vn/Trung-uong-quyet-dinh-phuong-an-nhan-su-cap-cao-post632739.html",
    chatOnly: false
  },
  success: (data) => {},
  fail: (err) => {}
});

Hoặc

import { openShareSheet } from "zmp-sdk/apis";

const shareLink = async () => {
  try {
    const data = await openShareSheet({
      type: "link",
      data: {
        link: "http://news.zing.vn/Trung-uong-quyet-dinh-phuong-an-nhan-su-cap-cao-post632739.html",
        chatOnly: false
      }
    });
  } catch (err) {}
};

Chia sẻ Official Account​

import { openShareSheet } from "zmp-sdk/apis";

openShareSheet({
  type: "oa",
  data: {
    id: "765465772305886642"
  },
  success: (data) => {},
  fail: (err) => {}
});

Hoặc

import { openShareSheet } from "zmp-sdk/apis";

const shareOA = async () => {
  try {
    const data = await openShareSheet({
      type: "oa",
      data: {
        id: "765465772305886642"
      }
    });
  } catch (err) {}
};

Chia sẻ GIF​

import { openShareSheet } from "zmp-sdk/apis";

openShareSheet({
  type: "gif",
  data: {
    imageUrl: "http://dev.org.zads.zdn.vn/2a16c7fefbbb12e54baa",
    gifUrl: "http://dev.org.zads.zdn.vn/fc88fe60c2252b7b7234",
    width: 480,
    height: 270
  },
  success: (data) => {},
  fail: (err) => {}
});

Hoặc

import { openShareSheet } from "zmp-sdk/apis";

const shareGIF = async () => {
  try {
    const data = await openShareSheet({
      type: "gif",
      data: {
        imageUrl: "http://dev.org.zads.zdn.vn/2a16c7fefbbb12e54baa",
        gifUrl: "http://dev.org.zads.zdn.vn/fc88fe60c2252b7b7234",
        width: 480,
        height: 270
      }
    });
  } catch (err) {}
};

Chia sẻ video​

import { openShareSheet } from "zmp-sdk/apis";

openShareSheet({
  type: "video",
  data: {
    videoThumb: "http://dev.org.zads.zdn.vn/fc88fe60c2252b7b7234",
    videoUrl: "http://dev.org.zads.zdn.vn/fc88fe60c2252b7b7234",
    width: 480,
    height: 270
  },
  success: (res) => {},
  fail: (err) => {}
});

Hoặc

import { openShareSheet } from "zmp-sdk/apis";

const shareVideo = async () => {
  try {
    const data = await openShareSheet({
      type: "video",
      data: {
        videoThumb: "http://dev.org.zads.zdn.vn/fc88fe60c2252b7b7234",
        videoUrl: "http://dev.org.zads.zdn.vn/fc88fe60c2252b7b7234",
        width: 480,
        height: 270
      }
    });
  } catch (err) {}
};

Chia sẻ page hiện tại của Zalo Mini App​

import { openShareSheet } from "zmp-sdk/apis";

openShareSheet({
  type: "zmp",
  data: {
    title: "My Zalo Mini App - HomePage",
    description: "Home page",
    thumbnail: "https://sample-videos.com/img/Sample-jpg-image-50kb.jpg"
  },
  success: (res) => {},
  fail: (err) => {}
});

Hoặc

import { openShareSheet } from "zmp-sdk/apis";

const shareCurrentPage = async () => {
  try {
    const data = await openShareSheet({
      type: "zmp",
      data: {
        title: "My Zalo Mini App - HomePage",
        description: "Home page",
        thumbnail: "https://sample-videos.com/img/Sample-jpg-image-50kb.jpg"
      }
    });
  } catch (err) {}
};

Chia sẻ page hiện tại của Zalo Mini App thông qua deep link​

import { openShareSheet } from "zmp-sdk/apis";

openShareSheet({
  type: "zmp_deep_link",
  data: {
    title: "My Zalo Mini App - HomePage",
    description: "Home page",
    thumbnail: "https://sample-videos.com/img/Sample-jpg-image-50kb.jpg"
  },
  success: (res) => {},
  fail: (err) => {}
});

Hoặc

import { openShareSheet } from "zmp-sdk/apis";

const shareCurrentPage = async () => {
  try {
    const data = await openShareSheet({
      type: "zmp_deep_link",
      data: {
        title: "My Zalo Mini App - HomePage",
        description: "Home page",
        thumbnail: "https://sample-videos.com/img/Sample-jpg-image-50kb.jpg"
      }
    });
  } catch (err) {}
};

openShareSheet

zi-chevron-up