[Android] 간단한 뮤직 플레이어 앱 만들기 : Service, MediaPlayer API

 

 

 

 

 

 

 

이번엔 Service를 이해하기 위한 뮤직 플레이어 앱을 만들어 보았다. 역시 Joyce님의 서적을 참고하였다.

 

---

 

💡 음악 재생 방법

(1) Raw 리소스를 이용하여 재생 (res/raw 폴더에 음악 파일을 직접 삽입)

val mPlayer : MediaPlayer? = MediaPlayer.create(this, R.raw.FILE_NAME)
mPlayer?.start()

(2) URI를 사용해 재생 (기기 안에 있는 오디오 파일의 위치 URI 값으로 재생)

val myUri: Uri = ... // URI 초기화
val mediaPlayer: MediaPlayer? = MediaPlayer().apply {
	setAudioStreamType(AudioManager.STREAM_MUSIC)
    setDataSource(applicationContextm, myUri)
    prepare()
    start()
}

 

 

 

 

---

 

💡 MediaPlayer 클래스 지원 함수

• 파일 준비
  - prepare() : 메인 스레드에서 실행, 용량 클 경우 ANR 가능성
  - prepareAsync() : 백그라운드 스레드에서 실행, ANR(응답없음) 발생하지 않음, onPreparedListener 사용 가능
  - setDataResource()
• 파일 재생
  - start() : 재생
  - pause() : 일시멈춤
• 파일 멈춤
  - reset() : 현재 재생되는 미디어 멈춤 및 MediaPlayer 객체 초기화
• 음악 길이 찾기
  - getDuration() : 음악의 길이, 단위는 밀리초(ms)로 반환
• 특정 구간 이동
  - seekTo()
• 자원 해제
  - release() : 사용하던 메모리와 자원 해제. MediaPlayer를 더 이상 사용하지 않는다면 반드시 release() 호출

 

 

 

 

---

 

💡 서비스의 생명 주기

안드로이드 4대 구성요소. 서비스는 독립된 구성요소이므로 독립된 생명 주기를 가짐 (액티비티가 소멸되어도 실행중)
크게 시작된 서비스와 바인드된 서비스 두 개로 나뉘며, 보통은 이 두 개를 같이 갖고 있는 경우가 많음

 

(1) startService()

• 액티비티나 다른 서비스에서 startService() 를 호출하면 서비스 시작
• 서비스 내의 콜백 메서드인 onCreate(), onStartCommand()가 호출되며 시작된 상태가 됨
• 한 번 시작된 상태의 서비스는 stopSelf() 함수로 알아서 중지하거나, 다른 구성요소가 stopService()를 호출하여 종료하기 전까지는 계속 실행중인 상태로 존재
• stopSelf() 혹은 stopService()로 종료된 뒤 onDestroy()를 거쳐 서비스 종료
• 참고로 아무리 많은 구성요소에서 startService()를 호출하더라도 서비스 객체 생성 및 onCreate() 호출은 처음 한 번

(2) bindService()

• 바인드된 서비스는 다른 구성요소와 연결이 된 동안 실행되는 서비스
• 다른 구성요소들에 바인드된 동안에만 실행되는 것이고, 계속 백그라운드에서 실행되는 것은 아님

 

바인딩된 서비스 개요  |  Background work  |  Android Developers

 

(3) 결론

• 시작된 서비스는 다른 구성요소와의 연결고리가 없으며 크기가 큰 동영상을 다운 받는 경우를 생각해볼 수 있음
• 바인드된 서비스는 다른 구성요소와 소통을 하며, 연결을 끊게되면 서비스가 종료되므로 계속 살아있어야 하는 태스크에는 부적절함
• 보통은 백그라운드에 남아있는 동시에 다른 구성요소와 연결되어 소통도 가능하게끔 두 개를 동시에 사용
  → startService()와 bindService() 둘 다 실행

 

 

 

 

---

 

💡 포그라운드와 백그라운드

• 포그라운드는 상태 표시줄에 알림이 표시되며, 사용자가 서비스가 실행되고 있음을 능동적으로 인지할 수 있는 서비스
• 백그라운드는 사용자가 보이지 않는 곳에서 조용히 작업 수행
• 안드로이드 API 레벨 26부터는 포그라운드 서비스를 통해 사용자에게 알리게끔 함
  startForegroundService()

[Android: Basic] 포그라운드 서비스 ( Foreground Service ) 개념

 

 

 

 

---

 

💡 매니페스트에 권한 및 서비스 추가

<manifest>
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE" /> // 추가
    
    <application   
    
        <service android:name=".MusicPlayerService"/> // 추가      
        
    </application>
</manifest>

 

 

 

💡 기본 서비스 틀 구현

package com.limheejin.musicplayer

import android.app.Service
import android.content.Intent
import android.os.IBinder

class MusicPlayerService : Service() {

    // onCreate() : startService()로 생성하든 bindService()로 생성하든, 서비스가 생성될 때 딱 한 번만 실행
    override fun onCreate() {
        super.onCreate()
        startForegroundService() // 포그라운드 서비스 시작
    }

    // 바인드 : bindService()를 호출할 때 실행되는 함수, 바인드가 필요없다면 null을 반환하면 됨
    override fun onBind(intent: Intent?): IBinder? {  // IBinder : 서비스와 구성요소를 이어주는 매개체 역할
        TODO("Not yet implemented")
    }

    // 시작된 상태 & 백그라운드 : startForegroundService() 호출할 때 실행되는 함수
    override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
        return super.onStartCommand(intent, flags, startId)
    }

    // 서비스 종료 : onCreate()에서 상태표시줄에 보여주었던 알림 해제
    override fun onDestroy() {
        super.onDestroy()
    }

	// 미리 함수 구성 생성해놓기
    fun startForegroundService() {} 
    fun isPlaying() {}
    fun play() {}
    fun pause() {}
    fun stop() {}

}

 

 

💡 구체적인 서비스 수정

package com.limheejin.musicplayer

import android.app.Notification
import android.app.NotificationChannel
import android.app.NotificationManager
import android.app.Service
import android.content.Intent
import android.media.MediaPlayer
import android.os.Binder
import android.os.Build

import android.os.IBinder
import android.widget.Toast

class MusicPlayerService : Service() {

    var mMediaPlayer: MediaPlayer? = null // 미디어 플레이어 객체를 null로 초기화
    var mBinder: MusicPlayerBinder = MusicPlayerBinder()

    inner class MusicPlayerBinder : Binder() { // 바인더를 반환하여 서비스 함수 쓸 수 있도록
        fun getService(): MusicPlayerService {
            return this@MusicPlayerService
        }
    }

    // onCreate() : startService()로 생성하든 bindService()로 생성하든, 서비스가 생성될 때 딱 한 번만 실행
    override fun onCreate() {
        super.onCreate()
        startForegroundService() // 포그라운드 서비스 시작
    }

    // 바인드 : bindService()를 호출할 때 실행되는 함수, 바인드가 필요없다면 null을 반환하면 됨
    override fun onBind(intent: Intent?): IBinder? {  // IBinder : 서비스와 구성요소를 이어주는 매개체 역할
        return mBinder // 위에서 만들어둔 바인더 객체를 반환값으로 전달
    }

    // 시작된 상태 & 백그라운드 : startForegroundService() 호출할 때 실행되는 함수
    override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
        return START_STICKY // START_STICKY, START_NOT_STICKY, START_REDELIVER_INTENT 중 하나 반환
        // START_STICKY : 시스템이 서비스를 중단하면 서비스를 다시 실행하고 onStartCommand() 호출
        // START_NOT_STICKY : 시스템이 서비스를 중단시키면 서비스를 재생성하지 않음
        // START_REDELIVER_INTENT : 시스템이 서비스를 중단하면 서비스를 다시 실행하고 onStartCommnad() 호출
        //                          +서비스 종료 전 마지막으로 전달된 인텐트 재전달. (반드시 명령을 실행해야 하는 경우)
    }

    // 서비스 종료 : onCreate()에서 상태표시줄에 보여주었던 알림 해제
    override fun onDestroy() {
        super.onDestroy()
        stopForeground(true) // 서비스가 중단될 때 포그라운드 서비스 멈춤
    }

    fun startForegroundService() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
            val notificationManager = getSystemService(NOTIFICATION_SERVICE) as NotificationManager
            val mChannel = NotificationChannel( // 알림 채널 생성 (필수)
                "CHANNEL_ID",
                "CHANNEL_NAME",
                NotificationManager.IMPORTANCE_DEFAULT
            )
            notificationManager.createNotificationChannel(mChannel)
        }
        val notification: Notification = Notification.Builder(this, "CHANNEL_ID")
            .setSmallIcon(R.drawable.ic_play) // 알림 아이콘
            .setContentTitle("뮤직 플레이어 앱") // 알림 제목 설정
            .setContentText("앱이 실행중입니다.") // 알림 내용 설정
            .build()
        startForeground(222, notification) // 인수로 알림 ID 식별자와 알림 지정, 그런데 이 부분에서 오류나서 꺼짐, 주석 처리 할 것
    }

    fun isPlaying(): Boolean {
        return (mMediaPlayer != null && mMediaPlayer?.isPlaying ?: false)
    }

    fun play() {
        if (mMediaPlayer == null) {
            // 음악 파일의 리소스를 가져와 미디어 플레이어 객체 할당
            mMediaPlayer = MediaPlayer.create(this, R.raw.singing_mp3)
            mMediaPlayer?.setVolume(1.0f, 1.0f) // 볼륨 지정
            mMediaPlayer?.isLooping = true // 반복 재생
            mMediaPlayer?.start() // 음악 재생
        } else { // 음악 재생 중인 경우
            if (mMediaPlayer!!.isPlaying){
                Toast.makeText(this, "이미 음악이 실행중입니다.", Toast.LENGTH_SHORT).show()
            }else {
                mMediaPlayer?.start() // 음악 재생
            }
        }
    }
    fun pause() {
        mMediaPlayer?.let{
            if (it.isPlaying){
                it.pause() // 일시정지
            }
        }
    }
    fun stop() {
        mMediaPlayer?.let {
            if(it.isPlaying) {
                it.stop() // 음악 멈춤
                it.release() // 미디어 플레이어에 할당된 자원 해제
                mMediaPlayer = null
            }
        }
    }

}

 

 

💡 간단한 액티비티 코드 틀

package com.limheejin.musicplayer

import android.os.Bundle
import android.view.View
import androidx.activity.enableEdgeToEdge
import androidx.appcompat.app.AppCompatActivity
import androidx.core.view.ViewCompat
import androidx.core.view.WindowInsetsCompat
import com.limheejin.musicplayer.databinding.ActivityMainBinding

class MainActivity : AppCompatActivity() , View.OnClickListener { // 뷰를 클릭했을 때 행동 정해주도록 구현

    private lateinit var binding : ActivityMainBinding

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        binding = ActivityMainBinding.inflate(layoutInflater)
        setContentView(binding.root)
        enableEdgeToEdge()
        ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.main)) { v, insets ->
            val systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars())
            v.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom)
            insets
        }
        
        binding.btnPlay.setOnClickListener(this)
        binding.btnPause.setOnClickListener(this)
        binding.btnStop.setOnClickListener(this)
    }
    
    override fun onClick(v: View?) {
        when(v?.id){
            R.id.btn_play -> {
                play()
            }
            R.id.btn_pause -> {
                pause()
            }
            R.id.btn_stop -> {
                stop()
            }
        }
    }

    override fun onResume() {
        super.onResume()
    }

    override fun onPause() {
        super.onPause()
    }
    
    private fun play() {
    }

    private fun pause() {
    }

    private fun stop() {
    }
}

 

 

💡 상세한 액티비티 코드

package com.limheejin.musicplayer

import android.content.ComponentName
import android.content.Context
import android.content.Intent
import android.content.ServiceConnection
import android.os.Build
import android.os.Build.VERSION_CODES.P
import android.os.Bundle
import android.os.IBinder
import android.view.View
import androidx.activity.enableEdgeToEdge
import androidx.appcompat.app.AppCompatActivity
import androidx.core.view.ViewCompat
import androidx.core.view.WindowInsetsCompat
import com.limheejin.musicplayer.databinding.ActivityMainBinding

class MainActivity : AppCompatActivity(), View.OnClickListener { // 뷰를 클릭했을 때 행동 정해주도록 구현

    private lateinit var binding: ActivityMainBinding
    private var mService: MusicPlayerService? = null // 서비스 변수

    private val mServiceConnection = object : ServiceConnection { // 서비스와 구성요소 연결 상태 모니터링
        override fun onServiceConnected(name: ComponentName?, service: IBinder?) {
            mService =
                (service as MusicPlayerService.MusicPlayerBinder).getService() // MusicPlayerBinder로 형변환
        }

        override fun onServiceDisconnected(name: ComponentName?) {
            mService = null // 만약 서비스가 끊기면, mService를 null로 만듦
        }
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        binding = ActivityMainBinding.inflate(layoutInflater)
        setContentView(binding.root)
        enableEdgeToEdge()
        ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.main)) { v, insets ->
            val systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars())
            v.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom)
            insets
        }

        binding.btnPlay.setOnClickListener(this)
        binding.btnPause.setOnClickListener(this)
        binding.btnStop.setOnClickListener(this)
    }

    override fun onClick(v: View?) {
        when (v?.id) {
            R.id.btn_play -> {
                play()
            }

            R.id.btn_pause -> {
                pause()
            }

            R.id.btn_stop -> {
                stop()
            }
        }
    }

    override fun onResume() {
        super.onResume()

        // 서비스 실행
        if (mService == null) {
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
                startForegroundService(Intent(this, MusicPlayerService::class.java))
            } else {
                startService(Intent(applicationContext, MusicPlayerService::class.java))
            }
        }

        // 액티비티를 서비스와 바인드
        val intent = Intent(this, MusicPlayerService::class.java)
        bindService(intent, mServiceConnection, Context.BIND_AUTO_CREATE) // 바인드할 시점에 서비스가 실행되지 않으면 AUTO CREATE
    }

    // onPause() : 사용자가 액티비티를 떠났을 때 실행
    override fun onPause() {
        super.onPause()
        
        if (mService != null) {
            if (!mService!!.isPlaying()) { // mService가 재생되고 있지 않다면 서비스를 중단
                mService!!.stopSelf() 
            }
            unbindService(mServiceConnection) // 서비스로부터 연결 끊기. 음악이 실행 중이면 바인딩만 해제
            mService = null
        }
    }

    private fun play() {
        mService?.play()
    }

    private fun pause() {
        mService?.pause()
    }

    private fun stop() {
        mService?.stop()
    }
}

 

 

 

---

🔥 완성

 

• 서비스를 이용한 음악 재생 앱이 완성되었다.
• 다만, 몇 가지 문제점이 있는데
  (1) 서비스의 startForeground 에서 오류가 나서 앱이 다운되는 문제
  (2) 백그라운드에서 음악 재생이 진행이 되나, 절전으로 인해 메모리에서 금방 앱이 킬링되어 노래가 멈추는 문제
  위와 같은 문제점들이 있었다.