public final class

ClipPlayer

org.smartrobot.android.clip.ClipPlayer

Class Overview

로보이드 스튜디오로 만든 클립 파일을 열거나 닫고, 재생 및 중지하는 메소드를 정의한다.

 public SampleActivity extends Activity
 {
     private ClipPlayer mClipPlayer;

     @Override
     protected void onCreate(Bundle savedInstanceState)
     {
         super.onCreate(savedInstanceState);
         mClipPlayer = ClipPlayer.obtain(this, 0);
     }

     @Override
     protected void onStart()
     {
         super.onStart();
         mClipPlayer.open("org.smartrobot.sample", R.raw.sample);
     }

     @Override
     protected void onStop()
     {
         super.onStop();
         mClipPlayer.close();
     }

     @Override
     public void onClick(View v)
     {
         switch(v.getId())
         {
         case R.id.play:
             mClipPlayer.play();
             break;
         case R.id.stop:
             mClipPlayer.stop();
             break;
         }
     }
 }

Summary

Nested Interfaces
interface ClipPlayer.OnCompletedListener 클립 파일의 재생이 완료되었을 때 호출되는 메소드를 정의한다.
interface ClipPlayer.OnErrorListener 클립 파일을 열거나 재생, 중지하는 과정에서 오류가 발생했을 때 호출되는 메소드를 정의한다.
Constants
int ERROR_ILLEGAL_STATE 클립 파일을 열거나 재생, 중지하는 순서가 잘못 되었음을 나타내는 오류 코드 상수.
int ERROR_INVALID_CLIP 잘못된 클립임을 나타내는 오류 코드 상수.
int ERROR_INVALID_CONTEXT 컨텍스트가 잘못 되었음을 나타내는 오류 코드 상수.
int ERROR_INVALID_FILE 클립 파일이 잘못 되었음을 나타내는 오류 코드 상수.
int ERROR_INVALID_ID 클립 재생기의 ID가 잘못 되었음을 나타내는 오류 코드 상수.
int ERROR_INVALID_PACKAGE 패키지 이름이 잘못 되었음을 나타내는 오류 코드 상수.
int ERROR_INVALID_RESOURCE 클립 파일의 리소스 ID 또는 리소스 이름이 잘못 되었음을 나타내는 오류 코드 상수.
int ERROR_INVALID_URL 클립 파일의 URL이 잘못 되었음을 나타내는 오류 코드 상수.
Public Methods
static void closeAll()
열려 있는 모든 클립 파일을 닫는다.
static ClipPlayer obtain(Context context, int clipPlayerId)
주어진 ID에 대한 클립 재생기의 인스턴스를 얻는다.
void close()
클립 파일을 닫는다.
int getId()
클립 재생기의 ID를 반환한다.
boolean open(String url)
클립 파일을 연다.
boolean open(String packageName, int resid)
클립 파일을 연다.
boolean open(String packageName, String resName)
클립 파일을 연다.
boolean play()
클립 파일을 재생한다.
void setOnCompletedListener(ClipPlayer.OnCompletedListener listener)
클립 파일의 재생이 완료되었을 때 호출되도록 listener를 설정한다.
void setOnErrorListener(ClipPlayer.OnErrorListener listener)
클립 파일을 열거나 재생, 중지하는 과정에서 오류가 발생했을 때 호출되도록 listener를 설정한다.
boolean stop()
클립 파일의 재생을 중지한다.

Constants

public static final int ERROR_ILLEGAL_STATE

라이브러리 버전 1.0.0부터

클립 파일을 열거나 재생, 중지하는 순서가 잘못 되었음을 나타내는 오류 코드 상수.

  • 상수 값: -8

public static final int ERROR_INVALID_CLIP

라이브러리 버전 1.0.0부터

잘못된 클립임을 나타내는 오류 코드 상수.

  • 상수 값: -6

public static final int ERROR_INVALID_CONTEXT

라이브러리 버전 1.0.0부터

컨텍스트가 잘못 되었음을 나타내는 오류 코드 상수.

  • 상수 값: -2

public static final int ERROR_INVALID_FILE

라이브러리 버전 1.0.0부터

클립 파일이 잘못 되었음을 나타내는 오류 코드 상수.

  • 상수 값: -7

public static final int ERROR_INVALID_ID

라이브러리 버전 1.0.0부터

클립 재생기의 ID가 잘못 되었음을 나타내는 오류 코드 상수.

  • 상수 값: -1

public static final int ERROR_INVALID_PACKAGE

라이브러리 버전 1.0.0부터

패키지 이름이 잘못 되었음을 나타내는 오류 코드 상수.

  • 상수 값: -4

public static final int ERROR_INVALID_RESOURCE

라이브러리 버전 1.0.0부터

클립 파일의 리소스 ID 또는 리소스 이름이 잘못 되었음을 나타내는 오류 코드 상수.

  • 상수 값: -5

public static final int ERROR_INVALID_URL

라이브러리 버전 1.0.0부터

클립 파일의 URL이 잘못 되었음을 나타내는 오류 코드 상수.

  • 상수 값: -3

Public Methods

public static void closeAll ()

라이브러리 버전 1.3.0부터

열려 있는 모든 클립 파일을 닫는다.

클립 파일을 닫은 후에는 play() 혹은 stop() 메소드를 호출하여 클립 파일을 재생하거나 중지할 수 없다. 애플리케이션이 종료되기 전에 반드시 생성된 모든 클립 재생기에 대해 close() 혹은 ClipPlayer.closeAll() 메소드를 호출하여 클립 파일을 닫아야 한다.

public static ClipPlayer obtain (Context context, int clipPlayerId)

라이브러리 버전 1.3.0부터

주어진 ID에 대한 클립 재생기의 인스턴스를 얻는다.

context가 null이면 null을 반환한다. clipPlayerId는 클립 재생기를 구분하기 위해 사용자가 지정하는 ID 값이다. clipPlayerId에 대한 클립 재생기 인스턴스가 이미 존재하는 경우에는 기존의 클립 재생기 인스턴스를 반환하고, 존재하지 않으면 새로 생성하여 반환한다.

Parameters
context 컨텍스트
clipPlayerId 클립 재생기의 ID
Returns
  • 클립 재생기의 인스턴스 또는 null

public void close ()

라이브러리 버전 1.0.0부터

클립 파일을 닫는다.

클립 파일을 닫은 후에는 play() 혹은 stop() 메소드를 호출하여 클립 파일을 재생하거나 중지할 수 없다. 애플리케이션이 종료되기 전에 반드시 생성된 모든 클립 재생기에 대해 close() 혹은 ClipPlayer.closeAll() 메소드를 호출하여 클립 파일을 닫아야 한다.

public int getId ()

라이브러리 버전 1.0.0부터

클립 재생기의 ID를 반환한다.

Returns
  • 클립 재생기의 ID

public boolean open (String url)

라이브러리 버전 1.0.0부터

클립 파일을 연다.

 void someMethod(ClipPlayer clipPlayer)
 {
     clipPlayer.open("http://www.sample.org/sample.mcs");
 }
Parameters
url 클립 파일의 URL
Returns
  • 성공하면 true, 아니면 false

public boolean open (String packageName, int resid)

라이브러리 버전 1.0.0부터

클립 파일을 연다.

 void someMethod(ClipPlayer clipPlayer)
 {
     clipPlayer.open("org.smartrobot.sample", R.raw.sample);
 }
Parameters
packageName 클립 파일이 있는 패키지의 이름
resid 클립 파일의 리소스 ID
Returns
  • 성공하면 true, 아니면 false

public boolean open (String packageName, String resName)

라이브러리 버전 1.0.0부터

클립 파일을 연다.

클립 파일(mcs 파일)은 raw 폴더에 있어야 하며, resName은 클립 파일의 확장자를 제외한 파일 이름이다.

 void someMethod(ClipPlayer clipPlayer)
 {
     clipPlayer.open("org.smartrobot.sample", "sample");
 }
Parameters
packageName 클립 파일이 있는 패키지의 이름
resName 클립 파일의 리소스 이름
Returns
  • 성공하면 true, 아니면 false

public boolean play ()

라이브러리 버전 1.0.0부터

클립 파일을 재생한다.

close() 혹은 ClipPlayer.closeAll() 메소드를 호출하여 클립 파일을 닫은 후에는 클립 파일이 재생되지 않고 false를 반환한다.

Returns
  • 성공하면 true, 아니면 false

public void setOnCompletedListener (ClipPlayer.OnCompletedListener listener)

라이브러리 버전 1.3.0부터

클립 파일의 재생이 완료되었을 때 호출되도록 listener를 설정한다.

Parameters
listener 설정할 리스너

public void setOnErrorListener (ClipPlayer.OnErrorListener listener)

라이브러리 버전 1.3.0부터

클립 파일을 열거나 재생, 중지하는 과정에서 오류가 발생했을 때 호출되도록 listener를 설정한다.

Parameters
listener 설정할 리스너

public boolean stop ()

라이브러리 버전 1.0.0부터

클립 파일의 재생을 중지한다.

close() 혹은 ClipPlayer.closeAll() 메소드를 호출하여 클립 파일을 닫은 후에는 false를 반환한다.

Returns
  • 성공하면 true, 아니면 false