이 튜토리얼에서는 Kotlin을 사용해 Android 기기의 상태를 감지하는 방법을 단계별로 살펴봅니다. 핵심 예제는 AudioManager를 활용해 현재 벨소리 모드(무음 · 진동 · 일반)를 판별하는 것이며, 마지막에는 기기의 사용자 에이전트(User Agent) 문자열을 확인하는 방법도 함께 소개합니다.
1단계 – 새 프로젝트 생성
Android Studio를 열고 File → New Project를 선택한 후, 안내에 따라 필요한 정보를 모두 입력하여 새 프로젝트를 생성합니다.
2단계 – 레이아웃 작성 (res/layout/activity_main.xml)
아래 코드를 activity_main.xml 파일에 추가합니다.
<?xml version="1.0" encoding="utf-8"?> <RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android" xmlns:tools="https://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" android:padding="16dp" tools:context=".MainActivity"> <TextView android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_centerHorizontal="true" android:layout_marginTop="50dp" android:text="Tutorials Point" android:textAlignment="center" android:textColor="@android:color/holo_green_dark" android:textSize="32sp" android:textStyle="bold" /> <TextView android:layout_width="match_parent" android:layout_height="wrap_content" android:layout_centerInParent="true" android:text="Detect Device Ringer Mode" android:textAlignment="center" android:textColor="@android:color/holo_red_dark" android:textSize="24sp" android:textStyle="bold" /> </RelativeLayout>
3단계 – 메인 액티비티 작성 (src/MainActivity.kt)
다음 코드를 MainActivity.kt에 추가합니다. 시스템 오디오 서비스를 가져온 뒤, Kotlin의 when 문으로 현재 벨소리 모드를 구분하고 각 상황에 맞는 토스트 메시지를 화면에 표시합니다.
import android.content.Context
import android.media.AudioManager
import android.os.Bundle
import android.widget.Toast
import androidx.appcompat.app.AppCompatActivity
import java.util.*
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
title = "KotlinApp"
val am = getSystemService(Context.AUDIO_SERVICE) as AudioManager
when (Objects.requireNonNull(am).ringerMode) {
AudioManager.RINGER_MODE_SILENT -> Toast.makeText(
this@MainActivity,
"Silent Mode",
Toast.LENGTH_SHORT
).show()
AudioManager.RINGER_MODE_VIBRATE -> Toast.makeText(
this@MainActivity,
"Vibrate Mode",
Toast.LENGTH_SHORT
).show()
AudioManager.RINGER_MODE_NORMAL -> Toast.makeText(
this@MainActivity,
"Normal Mode",
Toast.LENGTH_SHORT
).show()
}
}
}
4단계 – 매니페스트 설정 (androidManifest.xml)
아래 코드를 AndroidManifest.xml에 추가합니다.
<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="https://schemas.android.com/apk/res/android" package="com.example.q11"> <application android:allowBackup="true" android:icon="@mipmap/ic_launcher" android:label="@string/app_name" android:roundIcon="@mipmap/ic_launcher_round" android:supportsRtl="true" android:theme="@style/AppTheme"> <activity android:name=".MainActivity"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> </application> </manifest>
앱 실행 및 결과 확인
실제 Android 기기를 컴퓨터에 연결한 상태라고 가정하고 진행합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤, 툴바의 Run 
아이콘을 클릭하세요. 기기 목록에서 자신의 모바일 기기를 선택하면, 해당 기기 화면에 아래와 같은 결과가 표시됩니다.
- 무음 모드: “Silent Mode” 토스트 메시지 표시
- 진동 모드: “Vibrate Mode” 토스트 메시지 표시
- 일반 모드: “Normal Mode” 토스트 메시지 표시
응용: 사용자 에이전트(User Agent) 문자열 확인하기
기기의 사용자 에이전트를 직접 확인하고 싶다면 아래 코드를 활용할 수 있습니다. 시스템 속성에서 바로 읽어오거나, WebView를 사용하는 경우 전용 API를 이용할 수 있습니다.
// 시스템 속성에서 사용자 에이전트 가져오기
val userAgent = System.getProperty("http.agent")
Toast.makeText(this, userAgent, Toast.LENGTH_LONG).show()
// WebView를 사용하는 경우
// val ua = WebSettings.getDefaultUserAgent(context)
이처럼 AudioManager로 기기의 소리 설정 상태를 감지하고, 시스템 속성을 통해 사용자 에이전트를 확인하면 기기 환경에 따라 다르게 동작하는 유연한 앱을 만들 수 있습니다.