...

만보기

...

메시지(풍선메시지) 커스터마이징

Pedometer Preview Message 는 Pop 에서 사용하는 Preview 와 동일한 기능이며, 일정 조건을 만족하면 Pedometer 만보기 관련 Preview 를 메시지를 보여주는 기능입니다.

Pedometer preview 가 보이는 조건은 다음과 같습니다.

...

• Milestone 의 목표 걸음 수의 일정 % 이상일 때: 목표 달성까지 %s 걸음 남았습니다, 힘내세요!

  • % 는 pedometerMessageViewVisibleThreshold 를 통해 설정 (ex 80f = 80%)

...

• Milestone 목표 걸음 수 달성 시: 목표 달성! 지금 바로 %s 포인트 받아가세요!

그 외, Pedometer preview 가 보여지는 조건이 아닐 때는 Pop 에서 사용하는 Contents, Ad preview 가 Pop에서 관리되는 메시지가 보여지게 됩니다

적용방법

PedometerConfig 에 pedometerMessageViewVisibleThreshold, pedometerMessageViewClass 를 설정합니다.

...

pedometerMessageViewClass: PopPedometerMessageView 를 상속하는 pedometerMessageViewClass 를 설정합니다. custom class 를 사용하여 pedometer preview message 만보기 메시지(풍선메시지)의 ui 를 변경할 수 있습니다.

기본 제공하는 View 를 사용할 경우

...

• line 9: 직접 구현한 layout 을 사용할 수 있습니다.

• line 15: preview 가 그려질 때 updateView 가 호출 되며 UI 를 그릴 때 필요한 pedometer 만보기 정보들이 함께 넘어 옵니다.

  • currentStep: 현재 step

  • targetMilestone: 목표 Milestone

  • rewardableMilestone: 목표 달성한 Milestone

• line 16: rewardableMilestone != null 일 경우 목표 달성으로 인해 포인트를 쌓을 수 있는 상태를 뜻합니다.

• line 19: targetMilestone != null && currentStep < targetMilestone.getStep() 일 경우 걷기 진행 중을 뜻합니다.

• line 28: pedometer preview 만보기 메시지(풍선메시지)에 노출 될 text 를 return 합니다.

• line 33: preview 가 노출 될 시간을 return 합니다.

view 에서 사용할 수 있는 정보는 updateView 함수를 통해 넘어오는데 다음과 같습니다.

...

MyPedometerPopHeaderViewAdapter 에서 Pedometer 만보기 정보를 얻어올 때 사용 가능한 함수와 리스너는 다음과 같습니다.

Pedometer 만보기 정보를 리턴하는 함수

• navigateToPedometer(): Pedometer Fragment 로 화면 전환합니다.

• navigateToPedometerHistory(): PedometerHistory Fragment 로 화면 전환합니다.

• getMaxProgress(): Pedometer Header 상단에 표시되는 progress 의 최대 값 (10000)

• getProgress(): Pedometer Header 상단에 표시되는 progress 의 현재 값 ((걸음 수/마일스톤 목표 걸음 수) * maxProgress)

• isRewardable(): 적립가능 한 마일스톤이 있으면 true

• getStep(): 현재 걸음 수

• getMilestones(): 모든 마일스톤(List<Milestone>)

Pedometer 만보기 정보를 전달하는 리스너

• onStepChanged: 걸음 수 가 변했을 때 호출

• onMilestoneReached: 마일스톤 목표 달성 시 호출

• onMilestoneUpdated: 마일스톤 정보가 변경 됐을 때 호출

...