오디오/비디오 재생 동안 표시 유지 방법(HTML)

아티클
02/12/2016

[ 이 문서는 Windows 런타임 앱을 작성하는 Windows 8.x 및 Windows Phone 8.x 개발자를 대상으로 합니다. Windows 10용으로 개발하는 경우에는 최신 설명서를 참조하세요.]

DisplayRequest 클래스를 사용하여 로컬 또는 스트리밍 동영상을 재생하는 동안 디스플레이를 유지하는 방법에 대해 알아봅니다. 일반적으로 Windows 런타임 앱을 실행하는 장치는 사용자가 자리를 비우면 배터리 수명을 절약하기 위해 디스플레이를 흐리게 하고 결국에는 꺼지지만, 동영상 앱의 경우 사용자가 돌아왔을 때 다시 볼 수 있으려면 화면을 그대로 유지해야 합니다. DisplayRequest 클래스를 사용하면 Windows가 디스플레이를 켠 상태로 유지하여 사용자가 동영상을 볼 수 있게 할 수 있습니다.

알아야 할 사항

기술

Windows.System.Display

사전 요구 사항

이 항목에서는 기존 멀티미디어 앱에 코드를 추가하는 방법을 보여 줍니다. 특히, 특히 동영상 플레이어 이벤트 처리기에 대한 코드가 앱에 있어야 합니다. . 오디오 및 비디오 앱을 만드는 방법에 대한 자세한 내용은 빠른 시작: 앱에서 비디오 재생 및 빠른 시작: 앱에서 원격 재생 기능 사용을 참조하세요.

지침

단계 1: DisplayRequest 개체 만들기

전역 DisplayRequest 변수를 만듭니다. 이 변수를 null로 초기화합니다.


// Create this variable at a global scope.
var dispRequest = null;

단계 2: 동영상 재생 시작 직전 DisplayRequest 활성화

requestActive를 호출하여 Windows에 앱이 디스플레이를 유지해야 함을 알립니다.

다음 예제에서는 동영상 재생을 시작하기 전에 요청을 활성화합니다.

function startVideoPlayback() {
    
    if (dispRequest === null) {
        
        // Activate a display-required request. If successful, the screen is 
        // guaranteed not to turn off automatically due to user inactivity.
        dispRequest = new Windows.System.Display.DisplayRequest;
        dispRequest.requestActive();
        
        WinJS.log && WinJS.log("Display request activated", 
                               "sample", 
                               "status");
        
        
        // Insert your own code here to start the video.
        
    }
}

단계 3: 동영상 재생이 중지 또는 일시 중지되면 DisplayRequest 비활성화

동영상 재생이 재생 오류로 인해 중지, 일시 중지 또는 중단될 경우 디스플레이 요청을 해제하려면 requestRelease를 호출합니다. 앱에 활성 디스플레이 요청이 더 이상 없으면 Windows는 장치가 사용되지 않을 때 디스플레이를 흐리게 하고 결국에는 꺼서 배터리 수명을 절약합니다.

다음 예제에서는 요청을 비활성화합니다.

function stopVideoPlayback() {
    
    // Insert your own code here to stop the video.
    
    if (dispRequest != null) {
        
        // Deactivate the display request and set the var to null.
        dispRequest.requestRelease();
        dispRequest = null;
        
        WinJS.log && WinJS.log("Display request released", 
                               "sample",
                               "status");
        
    }
}

설명

참고 Windows는 앱이 화면을 떠나면 앱의 활성 디스플레이를 자동으로 비활성화하고 앱이 포그라운드로 돌아오면 다시 활성화합니다.

뿐만 아니라 이 API를 사용하여 GPS 앱에서 길을 안내하는 동안에도 화면을 유지할 수 있습니다. 이 경우 동영상 재생 이벤트를 탐색 이벤트로 대체합니다.

함수 컨텍스트에서 유사한 코드를 보려면 디스플레이 전원 상태 샘플을 참조하세요.

Share via