Основы облачного хранилища

использоватьuniCloudоблачное хранилище,Нет необходимости приобретать место для хранения отдельно, как в традиционной модели.、Сопоставление CDN、закупка трафика и т.д.;

Перенести файлы в облачное хранилище можно 3 способами:

1. Веб-консоль uniCloud: нажмите «Облачное хранилище».,Файл загрузить через веб-интерфейс. Интерфейс управления также обеспечивает просмотр ресурсов, удаление и другие рабочие интерфейсы.
2. Загрузка клиента：на переднем концеjsпозвонитьuniCloud.uploadFile。
3. Облачная функциязагрузить：существовать Облачная функцияjsпозвонитьuniCloud.uploadFile。

Что следует отметить:

• интерфейс и Облачная функцияконец,иметь то же имяapi：uniCloud.uploadFile。пожалуйста, не путайте。
• впередконец Есть еще одинuni.uploadFileизAPI,Этот API используется для подключения к загрузке, отличной от uniCloud. Пожалуйста, не запутайтесь.
• Из соображений безопасности загрузка файлов html временно запрещена в облачном хранилище.

В облачном пространстве, предоставляемом Alibaba Cloud в uniCloud, общий размер файла облачного хранилища ограничен 10 ГБ, а размер одного файла ограничен 100 МБ. Он поставляется с CDN и совершенно бесплатен. Эти бесплатные ресурсы можно использовать для обычной деятельности компании. Alibaba Cloud не позволяет разработчикам использовать эти бесплатные ресурсы хранилища и CDN для оказания услуг по работе с изображениями и постельным бельем.

Загрузка клиента

Прежде чем использовать uniCloud.uploadFile на клиенте, в белом списке загрузки необходимо настроить следующие доменные имена.

bsppub.oss-cn-shanghai.aliyuncs.com

Интерфейсная часть вызывает файл загрузки API облачного хранилища.

uniCloud.uploadFile({
  CloudPath: "Имя файла, отображаемое в облаке после загрузки", // Может иметь то же имя, не поддерживает подкаталоги
  filePath: "Путь к локальному файлу, который требует загрузки",
  success:(res)=>{//загрузитьпосле успехаизперезвонить
    //res.fileID — это адрес доступа к облаку после завершения загрузки файла, который можно использовать напрямую.
  },
  fail:()=>{},//загрузитьнеудачаизперезвонить
  onUploadProgress:()=>{//загрузить Обратный вызов прогресса
    
  }
})

Следующий код выбирает загрузку изображения из альбома мобильного телефона в облачное хранилище.

//Внешний код
uni.chooseImage({
  count: 1,
  success(res) {
    console.log(res);
    if (res.tempFilePaths.length > 0) {
      let filePath = res.tempFilePaths[0]
      //Выполняем операцию загрузки

      // метод обещания
      const result = await uniCloud.uploadFile({
        filePath: filePath,
        cloudPath: 'a.jpg',
        onUploadProgress: function(progressEvent) {
                console.log(progressEvent);
                var percentCompleted = Math.round(
                  (progressEvent.loaded * 100) / progressEvent.total
                );
              }
      });

      // callbackСпособ,иметод обещания Просто выберите одно из двух
      uniCloud.uploadFile({
        filePath: filePath,
        cloudPath: 'a.jpg',
        onUploadProgress: function(progressEvent) {
          console.log(progressEvent);
          var percentCompleted = Math.round(
            (progressEvent.loaded * 100) / progressEvent.total
          );
        },
        success() {},
        fail() {},
        complete() {}
      });
    }
  }
});

На внешнем интерфейсе мы можем только загружать файлы в облачное хранилище, но не удалять файлы из облачного хранилища. Удалить файлы в облачном хранилище или в uniCloud Веб-консоль или работайте в облачных функциях.

Работа с облачным хранилищем в облачных функциях

загрузить

const res = await uniCloud.uploadFile({
  CloudPath: "Имя файла, отображаемое в облаке после загрузки",
  fileContent: "Абсолютный путь к файлу или буферу файла"
})

console.log(res.fileID);//Адрес доступа к облаку после загрузки файла

Следующий код демонстрирует, как прочитать изображение по URL-адресу и сохранить его в собственном облачном хранилище.

const image = await uniCloud.httpclient.request("URL изображения");
    
const res = await uniCloud.uploadFile({
  CloudPath: "Имя файла, отображаемое в облаке после загрузки",
  fileContent:image.data//Файловый буфер
});

Примечание: если исходить из Загрузки клиента, не рекомендуется читать файл и затем передавать его Облачной через передачу параметров. функция,Затем из Облачной функции загрузить в облачное хранилище.,Облачное хранилище должно быть передано непосредственно клиенту.

удалить

const res = await uniCloud.deleteFile({
    fileList: [
        "fileID"//Адрес доступа к файлу в облачном хранилище
    ]
});

Обычная обработка файлов в облачном хранилище

При доступе к файлам изображений или видео в облачном хранилище мы можем обрабатывать файлы «на лету», добавляя некоторые параметры. Обратите внимание, что обработка вступает в силу в режиме реального времени и не приведет к каким-либо изменениям файлов в вашем облачном хранилище.

Изменение размера изображения

Вы можете настроить размер изображения с помощью параметра масштабирования изображения, который часто используется для создания миниатюр разных размеров.

Как использовать:

//fileID Пример https://vkceyugu.cdn.bspapp.com/VKCEYUGU-ef89fa94-5d19-4f01-b2b8-edc1f4387edc/b98b33ba-1595-4fda-995a-6c4e17a9e2c5.png
fileID?x-oss-process=image/resize, другие параметры

Описание параметра:

Что следует отметить:

• Ограничения на исходное изображение
  • Форматы изображений могут быть только: JPG, PNG, BMP, GIF, WebP, TIFF. Среди них изображения в формате GIF поддерживают заданное масштабирование по ширине и высоте, но не поддерживают пропорциональное масштабирование (в случае пропорционального масштабирования динамическое изображение станет статическим).
  • Размер исходного изображения не может превышать 20 МБ.
  • Ширина или высота не могут превышать 30 000. пикселей, а общее количество пикселей не может превышать 250 миллионов. px。динамические картинки（НапримерGIFкартина）из Расчет пикселей СпособдляШирина*Высота*Номер рамки изображения；Нетдинамические картинки（НапримерPNGкартина）из Расчет пикселей СпособдляШирина*Высота。
• Ограничения масштабирования: ширина или высота не могут превышать 16 384 пикселей, а общее количество пикселей не может превышать 16 777 216 пикселей.
• Если в URL-адресе указаны параметры масштабирования по ширине и высоте, а также параметры пропорционального масштабирования, будет выполнено только указанное масштабирование по ширине и высоте.
• При масштабировании указывайте только ширину или высоту
  • При пропорциональном масштабировании изображение масштабируется пропорционально. Например, исходное изображение — 200 px*100 пикселей, масштабируем высоту до 100 пикселей, то масштаб ширины равен 50. px。
  • При масштабировании с фиксированной шириной и высотой ширина и высота исходного изображения будут масштабироваться в соответствии с указанным значением. Например, исходное изображение — 200 px*100 пикселей, масштабируем высоту до 100 пикселей, ширина также масштабируется до 100. px。
• Если режим масштабирования — mfit и указано значение для самой длинной стороны l целевой карты масштабирования или самой короткой стороны s целевой карты масштабирования, то и l, и s будут масштабироваться с использованием указанного значения.
• Если указан режим масштабирования m и указано значение ширины w целевой карты масштабирования или высоты h целевой карты масштабирования, значение самой длинной стороны l целевой карты масштабирования или самой короткой стороны s карты масштабирования. целевая карта масштабирования не вступит в силу.
• Когда целевое увеличенное изображение больше исходного размера изображения,Вернуться к исходному изображению по умолчанию。ты можешь добавитьlimit_0Усиление параметровкартина。Например,https://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,w_500,limit_0

Обрезка изображения

Вы можете использовать параметры обрезки изображения, чтобы обрезать прямоугольное изображение указанного размера на исходном изображении.

Как использовать:

//fileID Пример https://vkceyugu.cdn.bspapp.com/VKCEYUGU-ef89fa94-5d19-4f01-b2b8-edc1f4387edc/b98b33ba-1595-4fda-995a-6c4e17a9e2c5.png
fileID?x-oss-process=изображение/обрезка, другие параметры

Описание параметра:

Что следует отметить:

При использовании функции пользовательской обрезки обратите внимание на следующее:

• Если горизонтальные и вертикальные координаты указанной начальной точки больше исходного изображения,вернетсяBadRequestошибка,Сообщение об ошибке: Положение предварительной резки находится за пределами изображения.
• Если указанные ширина и высота от начальной точки превышают исходное изображение, оно будет обрезано непосредственно до границы исходного изображения.

Добавить водяной знак к фотографиям

Вы можете использовать параметры водяного знака изображения, чтобы добавлять текст водяного знака или изображения водяного знака в файлы изображений в облачном хранилище.

Как использовать:

//fileID Пример https://vkceyugu.cdn.bspapp.com/VKCEYUGU-ef89fa94-5d19-4f01-b2b8-edc1f4387edc/b98b33ba-1595-4fda-995a-6c4e17a9e2c5.png
fileID?x-oss-process=изображение/водяной знак, другие параметры

Описание параметра:

• Основные параметры

• Параметры водяного знака изображения

• Параметры текстового водяного знака

• Параметры смешанного водяного знака изображения и текста

Кодировка водяного знака:

Во время операции добавления водяного знака такие параметры, как текстовое содержимое, цвет текста, шрифт текста и имя водяного знака изображения текстового водяного знака, должны быть закодированы в формате Base64, безопасном для URL. Этапы кодирования следующие:

1. Закодируйте содержимое в Base64.
2. Поместите результат виз Частичная замена кодировки。
   • Замените знак плюса (+) в результате на тире (-).
   • Замените косую черту (/) в результате подчеркиванием (_).
   • Опустите конечный знак равенства (=) в результате.

Что следует отметить:

• Водяные знаки изображений могут использовать только изображения в текущем пространстве памяти.,Сетевые или локальные изображения должны быть сохранены в текущем пространстве памяти, прежде чем их можно будет использовать.
• Водяной знак изображения в настоящее время поддерживает только форматы JPG, PNG, BMP, WebP и TIFF.
• К одному изображению можно добавить до трех различных водяных знаков, причем положения каждого водяного знака изображения не могут полностью перекрываться.
• Текстовые водяные знаки в настоящее время не поддерживают традиционный китайский язык.

Преобразование формата изображения

Вы можете использовать параметры преобразования формата для преобразования формата файлов изображений в облачном хранилище.

Как использовать:

//fileID Пример https://vkceyugu.cdn.bspapp.com/VKCEYUGU-ef89fa94-5d19-4f01-b2b8-edc1f4387edc/b98b33ba-1595-4fda-995a-6c4e17a9e2c5.png
fileID?x-oss-process=изображение/формат, другие параметры

Описание параметра:

Что следует отметить:

• Когда Обработка изображений включает в себя операции масштабирования,Рекомендуется помещать параметры преобразования формата в параметры обработки.изнаконец。Напримерimage/resize,w_100/format,jpg
• Обработка изображений при включении операций масштабирования и водяных знаков,Рекомендуется добавить параметр преобразования форматасуществовать После масштабирования параметров。Напримерimage/reisze,w_100/format,jpg/watermark,...

Изменение качества изображения

Вы можете использовать параметр «Изменение качества изображения», чтобы настроить качество изображения при извлечении файлов изображений в облачное хранилище.

Как использовать:

//fileID Пример https://vkceyugu.cdn.bspapp.com/VKCEYUGU-ef89fa94-5d19-4f01-b2b8-edc1f4387edc/b98b33ba-1595-4fda-995a-6c4e17a9e2c5.png
fileID?x-oss-process=изображение/качество, другие параметры

Описание параметра:

Что следует отметить:

Качественное преобразование поддерживает только JPG и WebP, другие форматы изображений не поддерживаются.

Видеозахват фотографий

Вы можете использовать параметр захвата видеокадра, чтобы получить изображение указанного кадра видеофайла в облачном хранилище.

Как использовать:

//fileID Пример https://vkceyugu.cdn.bspapp.com/VKCEYUGU-ef89fa94-5d19-4f01-b2b8-edc1f4387edc/b98b33ba-1595-4fda-995a-6c4e17a9e2c5.png
fileID?x-oss-process=изображение/снимок, другие параметры

Описание параметра:

Что следует отметить:

• Для видеофайлов с форматами кодирования видео H264 и H265 поддерживается только захват видеокадров.
• Захват видеокадра происходит в режиме реального времени.,Чтобы сохранить,Вам необходимо перенести его в облачное хранилище самостоятельно.