Google은 흑인 공동체를 위한 인종적 평등을 추구하기 위해 노력하고 있습니다. 자세히 알아보기
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

이미지 크기 조절

Firebase
Made by Firebase

Cloud Storage에 업로드된 이미지를 지정된 크기로 조절하고 원본 이미지는 유지하거나 삭제하도록 선택할 수 있습니다.

이 확장 프로그램의 작동 방식

이 확장 프로그램을 사용하면 Cloud Storage 버킷에 업로드된 이미지의 크기 조절된 버전을 만들 수 있습니다.

파일을 지정된 Cloud Storage 버킷에 업로드하면 이 확장 프로그램은 다음 작업을 수행합니다.

  • 파일이 이미지인지 여부를 감지합니다. 맞으면 다음 작업을 수행합니다.
  • 지정된 치수로 크기가 조절된 이미지를 만듭니다.
  • 크기가 조절된 이미지에 원래 업로드된 이미지와 동일한 이름을 사용하되 지정된 너비와 높이를 서픽스로 추가합니다.
  • 크기가 조절된 이미지를 원래 업로드된 이미지와 동일한 Storage 버킷에 저장합니다.

업로드되는 원본 이미지마다 다른 치수로 크기가 조절된 이미지를 만드는 확장 프로그램을 구성할 수도 있습니다. 예를 들어 200x200, 400x400, 680x680 크기의 이미지를 원한다면 확장 프로그램으로 크기가 조절된 이미지 3개를 만든 후 버킷에 저장할 수 있습니다.

확장 프로그램은 메타데이터가 있는 경우 자동으로 원본 이미지에서 크기가 조절된 이미지로 Cache-Control , Content-Disposition , Content-Encoding , Content-Language , Content-Type , 사용자가 제공한 메타데이터를 복사합니다(원본 메타데이터에 토큰이 포함된 경우 크기가 조절된 이미지에 새로운 Firebase Storage 다운로드 토큰이 생성됩니다). 확장 프로그램이 크기가 조절된 이미지의 Cache-Control 값을 덮어쓰도록 구성할 수도 있습니다.

이 확장 프로그램은 크기 조절 완료 이벤트를 게시할 수 있습니다. 필요한 경우 확장 프로그램을 설치할 때 이 이벤트를 사용 설정하면 됩니다. 이벤트를 사용 설정하면 이러한 이벤트에 응답하는 커스텀 이벤트 핸들러를 작성 할 수 있습니다. 나중에 언제든지 이벤트를 사용 설정하거나 사용 중지할 수 있습니다. 이벤트는 Eventarc를 통해 내보내집니다.

세부 구성 정보

이 확장 프로그램을 구성하려면 픽셀(px) 단위로 최대 너비 및 최대 높이를 지정합니다. 이 확장 프로그램은 업로드된 이미지의 가로세로 비율을 일정하게 유지하며 크기가 조절된 이미지의 치수가 지정된 최대 너비 및 높이를 초과하지 않을 때까지 이미지를 축소합니다.

예를 들어 최대 너비를 200px로, 최대 높이를 100px로 지정한다고 가정해 보겠습니다. 너비가 480px이고 높이가 640px인, 즉 가로세로 비율이 0.75인 이미지를 업로드합니다. 지정된 최대 치수를 초과하지 않는 선에서 가로세로 비율을 유지한 결과, 크기가 조절된 최종 이미지의 크기는 너비 75px, 높이 100px이 됩니다.

추가 설정

이 확장 프로그램을 설치하기 전에 먼저 Firebase 프로젝트에 Cloud Storage 버킷을 설정 했는지 확인합니다.

참고 : 위에서 언급한 것처럼 이 확장 프로그램은 지정된 Cloud Storage 버킷의 모든 변경사항을 수신 대기합니다. 이로 인해 불필요한 함수 호출이 발생할 수 있습니다. 특히 크기를 조절하려는 이미지용으로 별도의 Cloud Storage 버킷을 만들고 이 확장 프로그램이 해당 버킷을 수신 대기하도록 설정하는 것이 좋습니다.

이 확장 프로그램의 여러 인스턴스

동일한 프로젝트에서 이 확장 프로그램의 인스턴스 여러 개를 설치하여 서로 다른 경로에 대해 서로 다른 크기 조절 옵션을 구성할 수 있습니다. 그러나 이 확장 프로그램은 앞서 언급한 것처럼 지정된 Cloud Storage 버킷의 모든 변경사항을 수신 대기합니다. 즉, 파일이 버킷에 업로드될 때마다 모든 인스턴스가 트리거됩니다. 따라서 불필요한 함수 호출을 방지하려면 여러 경로를 사용하는 대신 여러 버킷을 사용하는 것이 좋습니다.

결제

확장 프로그램을 설치하려면 프로젝트에서 사용한 만큼만 지불하는 Blaze 요금제 를 이용해야 합니다.

  • 이 확장 프로그램에 필요한 Firebase 리소스에 대해 사용 여부와 관계없이 일반적으로 월 $0.01 정도의 소액이 청구됩니다.
  • 이 확장 프로그램은 서비스의 무료 등급을 초과하는 경우 관련 요금이 청구될 수 있는 다른 Firebase 및 Google Cloud Platform 서비스를 사용합니다.
  • Cloud Storage
  • Cloud Functions(Node.js 10 이상 런타임. FAQ 보기 )
  • 이벤트를 사용 설정하면 Eventarc 사용료가 부과 됩니다.

확장 프로그램 설치 방법

Firebase Console 사용

Firebase Console을 사용해 확장 프로그램을 설치하고 관리할 수 있습니다.

Console을 사용해 설치하기

Firebase CLI 사용

Firebase CLI를 사용해 확장 프로그램을 설치하고 관리할 수도 있습니다.

1단계: 다음 npm 명령어를 실행하여 CLI를 설치하거나 최신 CLI 버전으로 업데이트합니다.

npm install -g firebase-tools
작동하지 않는 경우 Firebase CLI 참조 를 살펴보거나 npm 권한 을 변경하세요.

2단계: 새 Firebase 프로젝트 디렉터리를 설정 하거나 기존 디렉터리로 이동합니다.

3단계: 다음을 실행하여 이 확장 프로그램을 확장 프로그램 매니페스트 에 추가합니다.

firebase ext:install firebase/storage-resize-images --local --project=projectId_or_alias

Step 4 (Optional): Test this extension locally with the Firebase Emulator Suite

firebase emulators:start

5단계: 매니페스트의 확장 프로그램을 프로젝트에 배포 합니다.

firebase deploy --only extensions --project=projectId_or_alias
지원
Cloud Storage
작성자
라이선스
Apache-2.0
버전
0.1.29