百度智能小程序 調(diào)起分享面板

2020-09-05 14:45 更新

swan.openShare

解釋?zhuān)?調(diào)起分享面板。

Web 態(tài)說(shuō)明:Web 態(tài)小程序運(yùn)行在微信、QQ、QQ 空間、微博、百度 Hi 內(nèi)時(shí),調(diào)用 openShare 會(huì)彈出引導(dǎo)浮層引導(dǎo)用戶(hù)通過(guò)平臺(tái)的分享能力進(jìn)行分享;在非上述環(huán)境時(shí)會(huì)彈出分享面板提示用戶(hù)復(fù)制鏈接并分享。

方法參數(shù)

Object object

object參數(shù)說(shuō)明

屬性名類(lèi)型必填默認(rèn)值說(shuō)明Web 態(tài)說(shuō)明
titleString分享標(biāo)題暫不支持
contentString分享內(nèi)容暫不支持
imageUrlString分享圖標(biāo)暫不支持
pathString頁(yè)面 path,必須是以 / 開(kāi)頭的完整路徑。如果 path 中的參數(shù)包含中文字符,需通過(guò) encodeURIComponent 對(duì)中文字符進(jìn)行編碼。Web 態(tài)小程序運(yùn)行在微信、QQ、QQ 空間、微博、百度 Hi 內(nèi)時(shí)配置的分享 path 不生效,此時(shí)分享 path 為當(dāng)前頁(yè)面的路徑
successFunction接口調(diào)用成功的回調(diào)函數(shù)
failFunction接口調(diào)用失敗的回調(diào)函數(shù)
completeFunction接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會(huì)執(zhí)行)

函數(shù)返回值

Boolean result

返回值說(shuō)明

反饋分享結(jié)果,成功或失敗。

fail 返回值參數(shù)說(shuō)明

Web 態(tài)

錯(cuò)誤信息(errMsg)類(lèi)型說(shuō)明
url copy failstring分享鏈接復(fù)制到剪切板失敗
share canceledstring取消分享面板
sharing guide canceledstring取消分享引導(dǎo)彈層

示例 

在開(kāi)發(fā)者工具中打開(kāi)


圖片示例

代碼示例

<view class="wrap">
    <view class="card-area">
        <button type="primary" open-type="share">組件方式打開(kāi)分享</button>
        <button type="primary" bindtap="openShare">API調(diào)用打開(kāi)分享</button>
        <view class="tip-week">不同方式調(diào)起分享面板</view>
    </view>
</view>
Page({
    onShareAppMessage() {
        return {
            title: '小程序標(biāo)題',
            content: '世界很復(fù)雜,百度更懂你',
            imageUrl: 'https://b.bdstatic.com/miniapp/images/baidulogo1.jpg',
            path: 'swan-api/open-share/open-share'
        };
    },
    openShare() {
        swan.openShare({
            title: '智能小程序示例',
            content: '世界很復(fù)雜,百度更懂你',
            path: 'swan-api/open-share/open-share?key=value',
            imageUrl: 'https://smartprogram.baidu.com/docs/img/logo_new.png',
            success: res => {
                swan.showToast({
                    title: '分享成功',
                    icon: 'none'
                });
                console.log('openShare success', res);
            },
            fail: err => {
                console.log('openShare fail', err);
            }
        });
    }
});

截屏分享二維碼說(shuō)明

自手百 11.23 以來(lái),小程序截屏分享增加了二維碼圖片標(biāo)識(shí)。

注意:該二維碼圖片標(biāo)識(shí) 60 天 內(nèi)失效,請(qǐng)勿在其他場(chǎng)景中使用,如需要長(zhǎng)期有效的二維碼,請(qǐng)到開(kāi)發(fā)者后臺(tái),或使用二維碼開(kāi)放接口生成。

截屏分享圖片示例

Bug & Tip

  • tip: 如果入?yún)?path 中的參數(shù)包含中文字符,需要通過(guò) encodeURIComponent 對(duì)中文字符進(jìn)行編碼,舉例:
let path = '/a/b?key=' + encodeURIComponent('中文');
  • bug: 基礎(chǔ)庫(kù) 1.13.43 版本 Android 手機(jī)中,點(diǎn)擊分享面板的取消時(shí),不會(huì)執(zhí)行 fail 回調(diào)。


以上內(nèi)容是否對(duì)您有幫助:
在線(xiàn)筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)