연동가이드

PowerSaver API ​

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

지원 환경

이 API는 Windows와 macOS 환경의 토스 POS에서 동작해요. Android, iOS 환경에서는 사용할 수 없으니 Device API의 platform 값을 확인한 뒤 호출해주세요.

Methods ​

startBlocking ​

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

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

await posPluginSdk.powerSaver.startBlocking();

Parameters ​

파라미터가 없어요.

Response ​

반환값이 없어요.

stopBlocking ​

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

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

await posPluginSdk.powerSaver.stopBlocking();

Parameters ​

파라미터가 없어요.

Response ​

반환값이 없어요.

isBlocked ​

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

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

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

Parameters ​

파라미터가 없어요.

Response ​

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

사용 예시 ​

작업 중 절전 모드 방지 ​

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

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

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