Sound API

POS 디바이스에서 오디오를 재생하는 API입니다. 알림음, 효과음 등을 URL 기반으로 재생할 수 있습니다.

Methods

play

오디오를 재생합니다.

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

posPluginSdk.sound.play({
    url: 'https://example.com/sound.mp3',
    volume: 100,
});

Parameters

파라미터	타입	필수	설명
url	string	O	재생할 오디오 파일의 URL
volume	number	O	볼륨 (0 ~ 100)
repeat	number	X	반복 횟수. 지정하지 않으면 1회 재생
durationMs	number	X	사운드 길이 (밀리초). 기본값: 2000. repeat 사용 시 다음 반복까지 대기 시간으로 사용되며, 0이면 즉시 반복 재생

사용 예시

주문 알림음 재생

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

posPluginSdk.order.on('add', () => {
    posPluginSdk.sound.play({
        url: 'https://example.com/order-alert.mp3',
        volume: 80,
    });
});

반복 재생

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

// 1초 간격으로 3회 반복 재생
posPluginSdk.sound.play({
    url: 'https://example.com/alert.mp3',
    volume: 100,
    repeat: 3,
    durationMs: 1000,
});

// 간격 없이 즉시 반복 재생
posPluginSdk.sound.play({
    url: 'https://example.com/alert.mp3',
    volume: 100,
    repeat: 3,
    durationMs: 0,
});