tt.shareAppMessage

2020-02-14 23:39 更新
基礎(chǔ)庫 1.0.0 開始支持本方法

tt.shareAppMessage(Object object)

主動拉起轉(zhuǎn)發(fā)界面。


輸入

繼承標(biāo)準(zhǔn)對象輸入

屬性類型是否必填說明最低版本
channelstring轉(zhuǎn)發(fā)內(nèi)容類型
templateIdstring分享素材模板 id,指定通過平臺審核的 templateId 來選擇分享內(nèi)容,需在平臺設(shè)置且通過審核1.22.3
descstring分享文案,不傳則默認(rèn)使用后臺配置內(nèi)容或平臺默認(rèn)。1.30.0
titlestring轉(zhuǎn)發(fā)標(biāo)題,不傳則默認(rèn)使用后臺配置或當(dāng)前小游戲的名稱。
imageUrlstring轉(zhuǎn)發(fā)顯示圖片的鏈接,可以是網(wǎng)絡(luò)圖片路徑或本地圖片文件路徑或相對代碼包根目錄的圖片文件路徑,顯示圖片長寬比推薦 5:4
querystring查詢字符串,必須是 key1=val1&key2=val2 的格式。從這條轉(zhuǎn)發(fā)消息進(jìn)入后,可通過 tt.getLaunchOptionSync() 或 tt.onShow() 獲取啟動參數(shù)中的 query。
extraobject附加信息

channel

說明
-默認(rèn)為卡片鏈接, channel 為空字符串或者不傳
article發(fā)布圖文內(nèi)容,抖音不支持
video發(fā)布視頻內(nèi)容
token口令分享,生成一串特定的字符串文本,僅頭條 APP 支持

extra

屬性類型默認(rèn)值說明
withVideoIdboolean是否支持跳轉(zhuǎn)到播放頁, 1.40.0+支持
videoPathstring視頻地址
videoTopicsarray視頻話題(只在抖音可用)
createChallengebooleanfalse是否分享為挑戰(zhàn)視頻 (頭條支持)


分享內(nèi)容優(yōu)先級

支持兩種形式來指定轉(zhuǎn)發(fā)的內(nèi)容(圖片、標(biāo)題、文案),最終按照優(yōu)先級規(guī)則進(jìn)行選擇, 詳情參考內(nèi)容轉(zhuǎn)發(fā)

  1. 代碼指定分享內(nèi)容(title、desc、imageUrl)
  2. 指定審核通過的模板素材 templateId
場景優(yōu)先級
端內(nèi)分享代碼指定分享內(nèi)容 > 指定模板 > 平臺默認(rèn)
端外分享指定模板 > 平臺默認(rèn)


示例

使用審核通過的分享素材

tt.shareAppMessage({
  templateId: "", // 替換成通過審核的分享ID
  query: "",
  success() {
    console.log("分享成功");
  },
  fail(e) {
    console.log("分享失敗");
  }
});

代碼指定分享內(nèi)容(圖片、標(biāo)題、描述)

tt.shareAppMessage({
  title: "測試分享",
  desc: "測試描述",
  imageUrl: "",
  query: "",
  success() {
    console.log("分享成功");
  },
  fail(e) {
    console.log("分享失敗");
  }
});

同時使用模板 templateId 和 分享內(nèi)容

tt.shareAppMessage({
  templateId: "", // 替換成通過審核的分享ID
  title: "測試分享",
  desc: "測試描述",
  imageUrl: "",
  query: "",
  success() {
    console.log("分享視頻成功");
  },
  fail(e) {
    console.log("分享視頻失敗");
  }
});

視頻分享

tt.shareAppMessage({
  channel: "video",
  title: "測試分享視頻",
  desc: "測試描述",
  imageUrl: "",
  templateId: "", // 替換成通過審核的分享ID
  query: "",
  extra: {
    videoPath: "ttfile://temp/test.mp4", // 可替換成錄屏得到的視頻地址
    videoTopics: ["話題1", "話題2"]
  },
  success() {
    console.log("分享視頻成功");
  },
  fail(e) {
    console.log("分享視頻失敗");
  }
});

口令分享

tt.shareAppMessage({
  channel: "token",
  title: "測試分享視頻",
  desc: "測試描述",
  templateId: "", // 替換成通過審核的分享ID
  query: "",
  success() {
    console.log("分享成功");
  },
  fail(e) {
    console.log("分享失敗");
  }
});
以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號