Screen.setAwakeMode

함수형 API setScreenAwakeMode로도 같은 기능을 쓸 수 있어요.

기능 설명

화면이 항상 켜져 있도록 설정하거나 해제해요. 웹툰, 동영상, 문서 읽기 등 화면을 계속 켜 두어야 할 때 유용해요.

enabled를 true로 설정하면 화면이 꺼지지 않고, false로 설정하면 기본 화면 보호기 시간에 따라 꺼져요. 앱 전체에 영향을 미치므로, 특정 화면에서만 쓰려면 화면을 벗어날 때 이전 상태로 복구해 주세요.

타입

Screen.setAwakeMode(options: SetScreenAwakeModeOptions): Promise<{ enabled: boolean }>;

Params

interface SetScreenAwakeModeOptions {
  enabled: boolean;
}

Response

적용된 상태를 { enabled: boolean } 형태로 반환해요.

예시 코드

import { Screen } from "@apps-in-toss/web-framework";

// 미디어 콘텐츠 화면에 진입할 때 항상 켜짐 모드를 켜요.
await Screen.setAwakeMode({ enabled: true });

// 화면을 벗어날 때 이전 상태로 복구해요.
window.addEventListener("pagehide", () => {
  Screen.setAwakeMode({ enabled: false });
});