[API Document] PicellUs Mobile Android Engine

PicellUs Mobile Android Engine  API Document

 

1.    개요

-       본 문서는 PicellUs 안드로이드 모바일 엔진에 대한 설치 및 사용법에 대한 가이드를 제공하는 문서입니다.

-       본 문서는 Android Studio 2021.1.1 기준으로 작성되었으며 Android Studio 버전에 따라 실제 내용이
        본 문서의 예제와 다를 수 있습니다.

 

2.    PicellUs 모바일 엔진의 주요 기능

-       이미지 파일 용량 경량화.

 

3.    라이브러리

-       picellus_lib-1.0.aar: PicellUs 안드로이드 모바일 엔진.

 

4.    적용 방법

4.1. 적용 전 준비 사항

-       PicellUs 안드로이드 모바일 엔진을 사용하기 위해서는 안드로이드 앱 개발 환경이 구성되어 있어야 합니다.

-       Android Studio : 최신 버전의 Android studio 권장.

-       테스트용 안드로이드 앱 : PicellUs 안드로이드 모바일 엔진을 적용할 테스트용 안드로이드 앱.

4.2. 라이브러리 적용

-       PicellUs 안드로이드 모바일 엔진은 aar 포맷으로 제공됩니다.

-       아래 내용은 Android Studio 에서 aar 파일을 어플리케이션에 등록하는 예제입니다.

(1) 테스트용 어플리케이션을 저장한 경로의 libs 폴더로 이동합니다.

(2) PicellUs 안드로이드 모바일 엔진 파일(picellus_lib-1.0.aar)을 테스트용 어플리케이션의 프로젝트의
      libs 폴더에 복사하여 저장합니다.

(3) Android Studio 에서 테스트용 어플리케이션을 불러옵니다.

(4) Module 의 build.gradle 파일에 repositories 항목을 아래와 같이 추가하고 dependencies 항목에
      PicellUs 안드로이드 모바일 엔진 관련 항목을 추가합니다.

     dependencies 항목의 picellusEngine 버전은 모듈과 함께 제공됩니다.

(5) implementation files('../libs/picellus_lib-1.0.aar')

(6) 어플리케이션에서 PicellUs 안드로이드 모바일 엔진을 import 하여 사용합니다.
       kr.co.wisedigm.picellus.library 패키지의 클래스를 사용합니다.

 

5.    API 와 예제

5-1. 초기화

Application class의 onCreate에서 PicellUs.init를 호출하면서 라이선스 값을 파라미터로 전달합니다.

5.2. API
PicellUs 초기화 후, PicellUs.getInstance()를 통해 method를 사용하면 됩니다.

-       saveCompressedBitmap – 불러온 이미지의 bitmap을 경량화 후 저장소에 저장한다.

 

5.3. 예제 어플리케이션

5.3.1. Sample Application (PicellusSample App)

-       본 문서와 함께 제공된 예제 어플리케이션을 실행한 결과 화면입니다.

(1)   예제 어플리케이션의 ‘SLIM AT CALLERY’ 버튼을 클릭합니다.

 

(2) 갤러리 어플리케이션에서 경량화할 이미지를 선택합니다.

(3) 원본 이미지와 경량화된 이미지가 화면에 표시됩니다.

(4)   ‘VIEW INFORMATION’ 버튼을 클릭하여 정보를 확인합니다.