JM21 Physical Key Event Logger

FiiO JM21(Android 13) 물리 키 전달 경로를 검증하기 위한 테스트 앱입니다.

구현 포인트

• MediaSessionService 기반 포그라운드 서비스에서 미디어 키 수신
• BroadcastReceiver(ACTION_MEDIA_BUTTON) 보조 수신 경로 제공
• Activity.dispatchKeyEvent 로 foreground 수신도 함께 기록
• 수집 필드: timestamp, keyCode, action, repeatCount, longPress, eventTime, downTime, deviceId, flags
• 환경 필드: screen on/off, lock 상태, app foreground/background, service 상태, media session 활성 상태
• 로그 제어: 시작/정지/초기화/CSV 저장

대상 키

• KEYCODE_VOLUME_UP
• KEYCODE_VOLUME_DOWN
• KEYCODE_MEDIA_NEXT
• KEYCODE_MEDIA_PLAY_PAUSE
• KEYCODE_MEDIA_PREVIOUS

참고

전원 버튼은 Android 일반 앱에서 직접 키 이벤트를 안정적으로 받기 어려워 화면 상태 확인 용도로만 사용합니다.

테스트 절차

• 상세 절차: docs/TEST_PROCEDURE.md

빠른 시작 (Android Studio)

1. Android Studio에서 프로젝트 루트를 엽니다.
2. Gradle Sync를 완료합니다.
3. 기기(또는 에뮬레이터) 선택 후 app 실행(▶).
4. 앱에서 서비스 시작을 누른 뒤 테스트를 진행합니다.

• 자세한 단계: docs/TEST_PROCEDURE.md

먼저 할 일: 프로젝트 파일 받기

아래 둘 중 하나만 하면 됩니다.

1. Git으로 받기(권장)
   • 터미널:
     • git clone <저장소_URL>
     • cd android_keytest
2. ZIP으로 받기
   • 저장소 페이지에서 Download ZIP
   • 압축 해제 후 폴더명을 android_keytest로 확인

그 다음 Android Studio에서 이 폴더를 Open 하세요.