🍅PomodoroTimer : 타이머 어플리케이션

🍅 PomodoroTimer 

º 프로젝트 인원 : 1명

º 프로젝트 기간 : 2022월 3월 17일 / 1일

---

 

🛠 개발환경 및 사용한 라이브러리

Development Environment

Android Studio (version : Arctic Fox | 2020.3.1 Patch 4)

 

Device

Galaxy - S20 5G (OS : Android 10 / API Level : 29)

 

Using Library

• CountDownTimer
• SoundPool

---

 

📜 Coding Convention

Coding Convention

Kotlin 공식 코딩 컨벤션

 

폴더구조

 

네이밍

• Class                     : Pascal Case
• Variable 및 Method  : Camel Case 
• Resource File          : Lower Snake Case

---

 

✉️ Commit Messge Rules

- feat   : 기능 (새로운 기능)
- design : UI 디자인

---

 

🏆 구현 기능

1. 1 ~ 60분 범위의 타이머 설정

    <!-- Gon : 한 시간을 최대 값으로 할 것이므로 SeekBar max값을 60으로 설정 -->
    <SeekBar
        android:id="@+id/controlMinutesSeekBar"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:layout_marginStart="15dp"
        android:layout_marginEnd="15dp"
        android:max="60"
        android:progressTint="@color/gray"
        android:thumb="@drawable/ic_thumb"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/remainMinutesTextView" />

controlMinutesSeekBar.setOnSeekBarChangeListener(object : SeekBar.OnSeekBarChangeListener{
            // Gon : 드래그 중 호출
            override fun onProgressChanged(seekBar: SeekBar?, progress: Int, fromUser: Boolean) {
                // Gon : 타이머를 1시간 기준으로 표현하기 위해 (progress * 1분) 인자로 넘김  
                if (fromUser)
                    updateRemainTime(progress * 60 * 1000L)
            }

            // Gon : 최초에 탭하여 드래그 시작 시 호출
            override fun onStartTrackingTouch(seekBar: SeekBar?) {
                stopCountDown()
            }

            // Gon : 드래그를 멈추는 경우 호출
            override fun onStopTrackingTouch(seekBar: SeekBar?) {
                if (seekBar == null) return

                if (seekBar.progress == 0) stopCountDown()
                else startCountDown(seekBar)
            }
        })

private fun updateRemainTime(millis: Long) = with(binding) {
        val remainSeconds = millis / 1000

        // Gon : 남은 전체 시간을 초로 받기 때문에 분,초를 표현하기 위해서 60(1분)으로 값 처리
        remainMinutesTextView.text = resources.getString(R.string.minutesFormat, remainSeconds / 60)
        remainSecondsTextView.text = resources.getString(R.string.secondsFormat, remainSeconds % 60)
    }

 

 

2. 1초 마다 화면 갱신

    // Gon : CountDown 시작
    private fun startCountDown(seekBar: SeekBar) {
        currentCountDownTimer = createCountDownTimer(seekBar.progress * 60 * 1000L).start()
        currentCountDownTimer?.start()

        //Gon : loop forever -> -1
        tickingSoundId?.let {
            soundPoll.play(it, 1F, 1F, 0, -1, 1F)
        }
    }
    
    
    // Gon : 종료까지 남은 밀리초, onTick() 메서드 호출 간격
    private fun createCountDownTimer(millis: Long): CountDownTimer =
        object: CountDownTimer(millis, 1000L) {

            override fun onTick(millisUntilFinished: Long) {
                updateRemainTime(millisUntilFinished)
                updateSeekBar(millisUntilFinished)
            }

            override fun onFinish() {
                completeCountDown()
            }
        }
        
        
    private fun updateRemainTime(millis: Long) = with(binding) {
        val remainSeconds = millis / 1000

        // Gon : 남은 전체 시간을 초로 받기 때문에 분,초를 표현하기 위해서 60(1분)으로 값 처리
        remainMinutesTextView.text = resources.getString(R.string.minutesFormat, remainSeconds / 60)
        remainSecondsTextView.text = resources.getString(R.string.secondsFormat, remainSeconds % 60)
    }


    private fun updateSeekBar(millis: Long) = with(binding) {
        // Gon : 남은 전체 밀리초로 받기 때문에 분 단위의 SeekBar를 표현하기 위해서 60000(1분)으로 값 처리
        controlMinutesSeekBar.progress = (millis / 60000).toInt()
    }

 

 

3. 타이머 효과음 및 종료 알림음

    private fun init() = with(binding) {
    
        ... 생략 ...
    
        tickingSoundId = soundPoll.load(this@MainActivity, R.raw.timer_tick, 1)
        bellSoundId = soundPoll.load(this@MainActivity, R.raw.timer_bell, 1)
    }
    
    
    private fun startCountDown(seekBar: SeekBar) {
        currentCountDownTimer = createCountDownTimer(seekBar.progress * 60 * 1000L).start()
        currentCountDownTimer?.start()

        //Gon : loop forever -> -1
        tickingSoundId?.let {
            soundPoll.play(it, 1F, 1F, 0, -1, 1F)
        }
    }
    
    
    private fun completeCountDown() {
        updateRemainTime(0)
        updateSeekBar(0)

        bellSoundId?.let {
            soundPoll.play(it, 1F, 1F, 0, 0, 1F)
        }
    }