做過微信分享功能的開發者大概都遇過這個坑:官方文件只示範了如何載入本地資源當縮圖,改用網路圖片時卻怎樣都失敗,而且連錯誤訊息都不給。本文記錄這個問題的成因與解法。
以下為網頁類型分享的官方範例:
// 初始化一個 WXWebpageObject 物件,填入 url
WXWebpageObject webpage = new WXWebpageObject();
webpage.webpageUrl = "網頁 url";
// 用 WXWebpageObject 初始化一個 WXMediaMessage 物件,填入標題、描述
WXMediaMessage msg = new WXMediaMessage(webpage);
msg.title = "網頁標題";
msg.description = "網頁描述";
Bitmap thumb = BitmapFactory.decodeResource(getResources(), R.drawable.send_music_thumb);
msg.thumbData = Util.bmpToByteArray(thumb, true);
// 構造一個 Req
SendMessageToWX.Req req = new SendMessageToWX.Req();
req.transaction = buildTransaction("webpage"); // 用於唯一標識一個請求
req.message = msg;
req.scene = isTimelineCb.isChecked()
? SendMessageToWX.Req.WXSceneTimeline
: SendMessageToWX.Req.WXSceneSession;
// 調用 api 介面發送資料到微信
api.sendReq(req);
縮圖的設定就是這一行:
msg.thumbData = 某個 bitmap 位元組陣列;
官方範例只示範了本地資源,看似只要把網路圖片轉成 Bitmap 就能解決。但實作後會發現自訂的 Bitmap 總是失敗,且不給任何提示訊息。追查之下才發現:微信分享的縮圖資料上限為 64KB。原圖稍大就會被靜默拒絕,這正是「毫無錯誤訊息卻失敗」的原因。
/**
* 把網路資源圖片轉化成 bitmap
* @param url 網路資源圖片網址
* @return Bitmap
*/
public static Bitmap GetLocalOrNetBitmap(String url) {
Bitmap bitmap = null;
InputStream in = null;
BufferedOutputStream out = null;
try {
in = new BufferedInputStream(new URL(url).openStream(), 1024);
final ByteArrayOutputStream dataStream = new ByteArrayOutputStream();
out = new BufferedOutputStream(dataStream, 1024);
copy(in, out);
out.flush();
byte[] data = dataStream.toByteArray();
bitmap = BitmapFactory.decodeByteArray(data, 0, data.length);
data = null;
return bitmap;
} catch (IOException e) {
e.printStackTrace();
return null;
}
}
private static void copy(InputStream in, OutputStream out) throws IOException {
byte[] b = new byte[1024];
int read;
while ((read = in.read(b)) != -1) {
out.write(b, 0, read);
}
}
Bitmap thumb = Bitmap.createScaledBitmap(
GetLocalOrNetBitmap("某個網路資源圖片網址"), 120, 120, true); // 壓縮 Bitmap
msg.thumbData = Util.bmpToByteArray(thumb, true);
如此一來縮圖大小就能控制在限制以內,分享功能便正常運作。
URL.openStream() 是同步阻塞的網路操作,在新版 Android 上於主執行緒執行會直接拋出 NetworkOnMainThreadException。請搭配非同步任務或協程處理。in 與 out 並未關閉,長時間使用會造成檔案描述符洩漏,建議改用 try-with-resources。Bitmap.compress() 指定品質與格式來控制位元組大小。GetLocalOrNetBitmap 回傳 null,呼叫端必須先判空,並準備一張預設縮圖作為後備。總結一句:微信分享縮圖失敗而無錯誤訊息,九成是超過 64KB。先下載、再縮放、最後轉位元組陣列,問題即可解決。