#BEAT ANDROID API 시작하기 BEAT 안드로이드 어플리케이션 연동을 위한 공개 API입니다.
- Minimum Android SDK : 11 (Honeycomb, 3.0)
- Target Android SDK : 19 (KitKat, 4.4)
- 연동하고자 하는 프로젝트에
IBeatApiService.java를import합니다.
- (
IBeatApiService.java는 본 저장소에서 제공하는 프로젝트의com.beatpacking.beat.services폴더에 있습니다.)
- BEAT 어플리케이션과 통신하기 위해
ServiceConnection을 열고IBeatApiService객체를 생성합니다.
- 생성된
IBeatApiService로 BEAT ANDROID API를 이용할 수 있습니다.
IBeatApiServiceapiService;
// BEAT와 연결@OverrideprotectedvoidonResume() {
super.onResume();
Intentintent = newIntent();
intent.setClassName("com.beatpacking.beat", "com.beatpacking.beat.services.PlayHeadService");
intent.putExtra("sender_id", getPackageName());
setIntent(intent);
bindService(getIntent(), connection, Context.BIND_AUTO_CREATE);
// 플레이헤드 표시여부 확인booleanvisible = apiService.isHeadVisible();
}
// BEAT와 연결 해제@OverrideprotectedvoidonPause() {
unbindService(connection);
super.onPause();
}
privateServiceConnectionconnection = newServiceConnection() {
publicvoidonServiceConnected(ComponentNamename, IBinderservice) apiService = IBeatApiService.Stub.asInterface(service);
messageHandler.sendMessageDelayed(Message.obtain(messageHandler, MSG_CONNECTED), 1000);
}
publicvoidonServiceDisconnected(ComponentNamename) {
}
};| Public Methods | Description |
|---|---|
int getBeatVersion() | 현재 BEAT 버전 가져오기 |
void setHeadVisible(boolean visibility) | 플레이헤드 표시/숨김 |
boolean isHeadVisible() | 플레이헤드 표시여부 확인 |
void setHeadLocation(int x, int y) | 스크린의 X(가로), Y(세로) 좌표로 플레이헤드를 이동시킴 |
int getHeadX() | 플레이헤드의 스크린상 X 좌표를 구함 |
int getHeadY() | 플레이헤드의 스크린상 Y 좌표를 구함 |
void pause() | 음악을 일시정지 시킴 |
void resume() | 음악을 재생시킴 |
boolean isAuthenticated() | 로그인 되어있는지의 여부를 구함 |
void setMovable(boolean movable) | 플레이헤드를 드래그하여 이동 가능/불가능하게 함 |
boolean isMovable() | 플레이헤드의 드래그 가능 여부를 구함 |
void setWidthRatio(float widthRatio) | 플레이헤드가 화면을 차지하는 비율 설정 |
float getWidthRatio() | 플레이헤드가 화면을 차지하는 비율을 구함 |
void setHideable(boolean hideable) | 플레이헤드를 화면의 상단, 하단으로 밀어넣어 숨기는 기능을 가능/불가능하게 함 |
boolean isHideable() | 플레이헤드의 숨김 가능 여부를 구함 |
beat-android-api is released under the MIT License.