gigagenie.init.onAppStatusChange

API 설명

어플리케이션이 Pause 되거나 Resume 될 경우에 이벤트를 알려준다. Pause는 사용자가 “기가지니” 등으로 Key Word Spotting을 하거나, 다른 Application(예: 결재 요청)을 호출하게 되면 Pause 가 발생한다. 이후 다시 어플리케이션이 실행되는 상황이 되면 Resume 이벤트가 발생한다. Pause 시에 TTS, 동영상 플레이 등이 중지되므로 Resume 이벤트를 받아서 어플리케이션 실행을 복구해야 한다.

API 구조

• gigagenie.init.onAppStatusChange 콜백 구현

• 콜백은 function callback(extra) 로 구현해야 하며 extra 는 다음의 int 값이 전달된다.

  • extra.changeStatus : Number, Mandatory로 다음의 값을 가진다.
    • extra.changeStatus=0: Resume 상태 진입
    • extra.changeStatus=1: Pause 상태 진입
  • extra.muteFlag: Number, Mandatory로 다음의 값을 가진다.
    • extra.muteFlag=false: unmute 상태 (음악등 재생 가능)
    • extra.muteFlag=true: mute 상태 (음악 등 재생 불가)

• 참고 자료: Mute/Unmute, App Pause/Resume Event 관련

사용 예시

gigagenie.init.onAppStatusChange = function (extra) {
    console.log(`onAppStatusChange: status=${extra.changeStatus}, mute=${extra.muteFlag}`);
    if (extra.changeStatus == 0) {
        if (extra.muteFlag == true) {
            // TODO: 일반적으로 서비스 종료 권고
            gigagenie.voice.svcFinished(null, function (result_cd, result_msg) {
                console.log(`Function svcFinished : ${result_cd}, ${result_msg}`);
            });
            return;
        } else {
            // TODO: Media Contents Resume
        }
    } else {
        // TODO: Media Contents Pause
    }
}