gallery


gallery는 3.0.0 버전 이상 부터 제공되며 해당 라이브러리를 추가하여 사용해야 된다.

gallery 은 HSP 에서 확장 라이브러리로 제공하는 API 로 aar 라이브러리 파일과 build.gradle 파일을 수정하여 사용할 수 있다. 

라이브러리 추가 방법은 Android 개발 가이드의 내용을 참조하면 된다.

gallery 은 안드로이드에 기본적으로 제공하는 갤러리 앱과 유사하지만 다중 선택 / 동영상 선택 기능을 가지고 있으며, Optional 한 기능이므로 사용자가 별도로 개발하여 사용해도 무방하다.


open

갤러리를 열어 미디어 파일을 선택할 수 있다. 이때 옵션을 통해 최대 선택 개수를 지정하거나 이미지나 동영상 파일들만 선택할 수 있도록 지정할 수도 있다. 

옵션은 DAPGallery.Params 를 통해 전달할 수 있으며 해당 클래스는 아래와 같이 구성된다. 

Params Class

public static class Params {
   public int type;
   public int maxCount = MAX_COUNT_VALUE;
}

Params

파라매터설명비고M/O
type

0: 이미지

1: 비디오

 M
maxCount선택할 수 있는 최대 개수 (최대 : 9) type이 0(이미지)인 경우만 유효하며 1(비디오)인 경우 maxCount 값 상관없이 1개로 설정 O
    

Example

val params = DAPGallery.Params(0, 9)

DAPGallery.open(this@MainActivity, params, {
   // TODO
   for (path in it) {
        // path
   }
}) {
   // TODO
}
DAPGallery.Params params = new DAPGallery.Params(0, 9);

DAPGallery.open(MainActivit.this, params, paths -> {
      for (String path : paths) {
          // path
      }
   }, e -> {
       // TODO
   });

Error Code

CodeCauseComment 
E12000파라메터 값이 잘못되어 있을 경우 
E12001전달된 액션 값이 알 수 없는 액션일 경우 
E12002타입 값이 0(이미지) ~ 1(비디오) 사이의 정수값이 아닌 경우 
E12003선택할 수 있는 최대 개수 값이 1 ~ 9 사이의 정수값이 아닌 경우 type이 0(이미지)인 경우만 유효하며 1(비디오)인 경우 입력값 상관없이 1개로 설정  
E12050실행 중 오류가 발생 되었을 경우 
E12051이미지 처리 중 오류가 발생 되었을 경우 
E12052사용자가 실행을 취소 하였을 경우 
E12099알 수 없는 오류가 발생 되었을 경우