PowerSaver API

POS 디바이스의 절전 모드를 제어하는 API예요. 장시간 화면이 필요한 작업 중 절전 모드로 전환되는 것을 방지할 수 있어요.

지원 환경

이 API는 Windows와 macOS 환경의 토스 POS에서 동작해요. 그 외 플랫폼에서 호출하면 에러가 발생하니 Device API의 platform 값을 확인한 뒤 호출해주세요.

Methods

startBlocking

절전 모드 방지를 시작해요.

import { posPluginSdk } from '@tossplace/pos-plugin-sdk';

await posPluginSdk.powerSaver.startBlocking();

Parameters

파라미터가 없어요.

Response

반환값이 없어요.

stopBlocking

절전 모드 방지를 해제해요.

import { posPluginSdk } from '@tossplace/pos-plugin-sdk';

await posPluginSdk.powerSaver.stopBlocking();

Parameters

파라미터가 없어요.

Response

반환값이 없어요.

isBlocked

절전 모드 방지가 현재 활성화 상태인지 확인해요.

import { posPluginSdk } from '@tossplace/pos-plugin-sdk';

const isBlocked = await posPluginSdk.powerSaver.isBlocked();

Parameters

파라미터가 없어요.

Response

Promise<boolean> — 절전 모드 방지가 활성화 상태면 true예요.

사용 예시

작업 중 절전 모드 방지

import { posPluginSdk } from '@tossplace/pos-plugin-sdk';

async function processLongTask() {
    await posPluginSdk.powerSaver.startBlocking();

    try {
        // 장시간 작업 처리
    } finally {
        await posPluginSdk.powerSaver.stopBlocking();
    }
}