openShareSheet

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

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

• API: 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

Property	Type	Default	Required	Description	Minimum Version
type	string		true	Nhậ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
data	object		true	Nội dung cần chia sẻ
success	function			Callback function khi gọi api thành công
fail	function			Callback function khi gọi api thất bại n

Object data

Chia sẻ hình ảnh (type='image')

Property	Type	Default	Required	Description	Minimum Version
imageUrl	string		true	Url hình ảnh cần chia sẻ

Chia sẻ liên kết (type='link')

Property	Type	Default	Required	Description	Minimum Version
link	string		true	Liên kết cần chia sẻ
chatOnly	boolean	true		Chỉ chia sẻ qua cửa sổ chat

Chia sẻ Official Account (type='oa')

Property	Type	Default	Required	Description	Minimum Version
id	string		true	Id của official account

Chia sẻ ảnh động (type='gif')

Property	Type	Default	Required	Description	Minimum Version
gifUrl	string		true	Url ảnh động cần chia sẻ
imageUrl	string			Url hình ảnh đại diện
width	number			Chiều rộng
height	number			Chiều cao

Chia sẻ video (type='video')

Property	Type	Default	Required	Description	Minimum Version
videoThumb	string		true	Url thumbnail cho video
videoUrl	string		true	Url video
width	number			Chiều rộng
height	number			Chiều cao

Chia sẻ page hiện tại của Zalo Mini App (type='zmp')

Property	Type	Default	Required	Description	Minimum Version
title	string		true	Tiêu đề cần chia sẻ
description	string		true	Mô tả
thumbnail	string		true	Url thumbnail cho Zalo Mini App
path	string			Đườ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>

Property	Type	Description	Minimum Version
status	number	Có 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
shareType	number	Trạ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
numberOfUser	number	Số 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 api from 'zmp-sdk';

api.login({
  success: () => {
    api.openShareSheet({
      type: 'image',
      data: {
        imageUrl: 'http://dev.org.zads.zdn.vn/2a16c7fefbbb12e54baa'
      },
      success: (data) => {},
      fail: (err) => {}
    });
  },
  fail: (error) => {
    console.log(error);
  }
});

Chia sẻ liên kết

import api from 'zmp-sdk';

api.login({
  success: () => {
    api.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) => {}
    });
  },
  fail: (error) => {
    console.log(error);
  }
});

Chia sẻ Official Account

import api from 'zmp-sdk';

api.login({
  success: () => {
    api.openShareSheet({
      type: 'oa',
      data: {
        id: '765465772305886642'
      },
      success: (data) => {},
      fail: (err) => {}
    });
  },
  fail: (error) => {
    console.log(error);
  }
});

Chia sẻ GIF

import api from 'zmp-sdk';

api.login({
  success: () => {
    api.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) => {}
    });
  },
  fail: (error) => {
    console.log(error);
  }
});

Chia sẻ video

import api from 'zmp-sdk';

api.login({
  success: () => {
    api.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) => {}
    });
  },
  fail: (error) => {
    console.log(error);
  }
});

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

import api from 'zmp-sdk';

api.login({
  success: () => {
    api.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) => {}
    });
  },
  fail: (error) => {
    console.log(error);
  }
});