您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

微信 JSSDK 多圖串行上傳實作,並修正 iOS 端一直卡在載入的問題

編輯:iOS 開發綜合

微信 JSSDK 的 wx.uploadImage 一次只能處理一張圖片,也就是說多圖上傳必須「一張接一張」地串行執行,無法並行送出。本文示範如何用遞迴把這件事優雅地寫出來,並解決 iOS 上會永遠停在載入狀態的隱藏地雷。

一、寫一個可重複呼叫的上傳函式

核心思路是:每次取出陣列的第一張,上傳成功後把它移出佇列,再呼叫自己處理下一張;當佇列清空,就代表全部完成,可以關掉 loading 並送出表單。

var serverIds = [];

function uploadImages(localImagesIds) {
    // 佇列空了,代表上傳完畢
    if (localImagesIds.length === 0) {
        $.showPreloader('正在提交數據...');
        $('form').submit();
        return;
    }

    wx.uploadImage({
        localId: localImagesIds[0],   // chooseImage 取得的本地 ID
        isShowProgressTips: 1,        // 預設 1,顯示進度提示
        success: function (res) {
            serverIds.push(res.serverId);  // 回傳伺服器端 ID
            localImagesIds.shift();        // 把已完成的那張移出佇列
            uploadImages(localImagesIds);  // 遞迴處理下一張
        },
        fail: function (res) {
            $.alert('上傳失敗,請重新上傳!');
        }
    });
}

二、點擊圖片框時選擇照片

使用者點一下預留的 img 元素,就跳出微信的選圖介面。這裡把回傳的 localId 直接寫進 src,一方面做預覽,一方面也方便稍後收集待上傳清單。

$('#uploadImages img').on('click', function () {
    var $img = $(this);

    wx.chooseImage({
        count: 1,                            // 一次選幾張,預設 9
        sizeType: ['original', 'compressed'],// 原圖或壓縮圖,預設兩者皆可
        sourceType: ['album', 'camera'],     // 相簿或相機,預設兩者皆可
        success: function (res) {
            var localIds = res.localIds;     // 選定照片的本地 ID 清單
            $img.attr('src', localIds[0]).addClass('uploaded');
        },
        fail: function (res) {
            alert(JSON.stringify(res));
        }
    });
});

三、按下送出,交給遞迴接力

收集所有已選取的縮圖 src,組成待上傳佇列後丟給 uploadImages,剩下的就交給遞迴一首接一首地傳。

$('#btnSubmit').on('click', function () {
    var $chooseImages = $('#uploadImages img.uploaded');

    if ($chooseImages.length === 0) {
        $.alert('請上傳照片!');
        return;
    }

    $.showPreloader('正在上傳照片...');

    var localImagesIds = [];
    $chooseImages.each(function () {
        localImagesIds.push($(this).attr('src'));
    });

    uploadImages(localImagesIds);
});

四、Android 一切正常,iOS 卻永遠轉圈圈

邏輯看起來無懈可擊,Android 實測也完全沒問題,但 iOS 就是卡在上傳階段,畫面一直顯示載入中。反覆檢查程式碼找不到任何毛病——問題出在微信 iOS 端回傳的 localId 格式上。

iOS 版的 chooseImage 有時會回傳以 wxlocalresource 開頭的資源標識,而 wx.uploadImage 期待的是 wxLocalResource 這樣的駝峰寫法。大小寫不一致,於是請求永遠等不到回應。

五、修正方式:正規化 localId

在上傳前把前綴做一次替換即可,Android 不受影響(因為根本不含這個字串):

var localId = localImagesIds[0];   // 修正 iOS 無法上傳的問題

if (localId.indexOf("wxlocalresource") != -1) {
    localId = localId.replace("wxlocalresource", "wxLocalResource");
}

整合後完整的 uploadImages 長這樣:

function uploadImages(localImagesIds) {
    if (localImagesIds.length === 0) {
        $.showPreloader('正在提交數據...');
        $('form').submit();
        return;
    }

    var localId = localImagesIds[0];

    // 關鍵修正:把 iOS 回傳的前綴改成 uploadImage 認得的寫法
    if (localId.indexOf("wxlocalresource") != -1) {
        localId = localId.replace("wxlocalresource", "wxLocalResource");
    }

    wx.uploadImage({
        localId: localId,
        isShowProgressTips: 1,
        success: function (res) {
            serverIds.push(res.serverId);
            localImagesIds.shift();
            uploadImages(localImagesIds);
        },
        fail: function (res) {
            $.alert('上傳失敗,請重新上傳!');
        }
    });
}

以上就是微信 JSSDK 多圖串行上傳的完整做法與 iOS 卡住的成因。實務上還建議替遞迴加上失敗重試次數上限,避免某張圖一直失敗造成無限迴圈;同時在全部完成後記得把 serverIds 一併提交給後端。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved