Pulse Phone 문서
Pulse Phone 개발자 API
Pulse Phone은 다른 리소스에 서버와 클라이언트 API를 제공합니다. 플레이어의 번호 읽기, 문자·메일·알림 보내기, 통화 걸기, 휴대폰에서 일어나는 일에 반응하기, 직접 만든 앱 추가가 가능합니다. 이 페이지의 내용은 모두 Pulse Phone 1.5.0의 phone 리소스를 기준으로 합니다. 모든 인자를 포함한 전체 목록은 Export와 이벤트에 있습니다.
API 위치
리소스 이름은 phone이므로 모든 호출은 exports.phone:... 형태입니다. 사용하기 전에 휴대폰이 준비되기를 기다리세요. IsReady()는 데이터베이스가 응답하고 휴대폰이 요청을 받을 수 있게 되면 true가 됩니다.
CreateThread(function()
while GetResourceState('phone') ~= 'started' or not exports.phone:IsReady() do Wait(500) end
print('Pulse Phone is ready')
end)서버 콘솔에서 phone_api를 실행하면 앱 API의 간단한 요약이 출력됩니다.
가장 많이 쓰는 서버 export
| Export | 하는 일 |
|---|---|
GetPhoneNumber(src) |
플레이어가 가진 휴대폰의 번호. 로딩이 끝나기 전에는 nil |
SourceOfNumber(number) |
그 번호를 가진 온라인 플레이어. 없으면 nil |
Notify(src, { title, body, app?, actions? }) |
그 플레이어의 휴대폰에 보내는 알림(버튼 최대 3개) |
SendMessage(src, number, text) |
그 플레이어가 번호로 보내는 문자 |
SendMail(address, sender, subject, body) |
주소로 보내는 메일 |
Call(src, number, video?) |
그 플레이어 대신 전화를 건다 |
SetPhoneDisabled(src, bool) |
플레이어의 휴대폰을 끄거나 켠다(감옥, 컷신 등) |
RecordTransaction(number, 'sent' or 'received', amount, party, note?) |
지갑의 명세 줄. 돈은 움직이지 않습니다 |
다른 휴대폰용으로 작성된 스크립트는 그 휴대폰의 export 대신 다음을 호출합니다:
| Export | 하는 일 |
|---|---|
ResolvePhone(target[, cb]) |
{ source }, { number }, { email }, { identifier }, { imei } 중 하나로 휴대폰을 찾는다 |
DeliverMailTo(target, mail[, cb]) |
그 휴대폰으로 보내는 메일: { sender, subject, body } |
SendText(from, to, body[, opts][, cb]) |
휴대폰 또는 이름을 붙인 서비스에서 보내는 문자 |
DispatchAlert(jobs, { title, body, coords? }) |
해당 직업의 근무 중인 모든 구성원에게 보내는 알림. 몇 명에게 전달됐는지 반환한다 |
예: 강도 스크립트가 지도 핀과 함께 경찰에 알립니다.
local reached = exports.phone:DispatchAlert({ 'police', 'sheriff' }, {
title = 'Store robbery',
body = 'Alarm at the 24/7 on Innocence Blvd.',
coords = vector3(25.7, -1345.6, 29.5),
})서버 이벤트
서버 스크립트에서 AddEventHandler로 수신합니다. 이벤트는 휴대폰만 발생시키며, 클라이언트가 위조할 수 없습니다.
| 이벤트 | 인자 |
|---|---|
phone:numberChanged |
src, number, oldNumber |
phone:callStarted |
callId, fromNumber, toNumber, fromSrc, toSrc, video |
phone:callEnded |
fromNumber, toNumber, reason, durationMs, fromSrc, toSrc, callId |
phone:messageSent |
fromNumber, toNumber, body |
phone:emergencyCall |
src, service, reason, coords |
phone:wallet:transfer |
fromNumber, toNumber, amount, note |
phone:notification:action |
src, app, notificationId, actionId: Notify가 보여 준 버튼이 눌렸다 |
클라이언트 export
| Export | 하는 일 |
|---|---|
Open(), Close(), IsOpen() |
휴대폰을 열거나 닫는다. Open은 아래의 모든 차단을 따른다 |
AddOpenCheck(fn) |
fn()이 false를 반환하면 휴대폰이 열리지 않는다. 리소스가 중지되면 제거된다 |
SetRestriction(key, mode) |
직접 정의하는 플레이어 상태: 'block', 'emergency-only', 해제하려면 nil |
SetCarAudio(state) |
차량 화면인 Pulse Drive에 내 카 스테레오를 표시한다 |
GetPhoneNumber(), IsInCall(), GetBattery() |
이 플레이어 본인의 휴대폰 |
예: 플레이어가 감옥에 있는 동안 휴대폰을 쓰지 못하게 합니다.
exports.phone:SetRestriction('myjail', 'block') -- on entering the cell
exports.phone:SetRestriction('myjail', nil) -- on releaseState bag
서버는 다른 휴대폰 리소스가 쓰는 이름 그대로 이 값을 Player(src).state에 기록하므로, HUD와 디스패치 스크립트는 수정 없이 읽을 수 있습니다: phoneNumber, phoneOpen, inCall, onCallWith, phoneBattery, phoneDead. 클라이언트는 자신의 값을 LocalPlayer.state.phoneOpen으로 읽습니다.
config 예제
휴대폰 설정은 phone/config/에 있습니다. 다른 스크립트가 의존하는 세 가지입니다:
Config.Item = {
required = false, -- true: the player needs the phone item
name = 'phone',
}
Config.Public = {
numberState = true, -- publish Player(src).state.phoneNumber
}
Config.Open = {
blockWhenNuiFocused = true, -- no phone while another menu holds the cursor
}직접 만든 앱
exports.phone:RegisterApp({ id, name, colour, icon, page = { kind = 'frame', url = 'ui/index.html' } })는 홈 화면과 App Hub에 앱을 추가합니다. 페이지는 자체 프레임에서 실행되며 휴대폰을 통해 서버와 통신합니다. 권한, 알림, 언어, App Hub 등록은 선택 항목입니다. 전체 가이드는 커스텀 앱입니다.
연동 노트
- Pulse Phone은 lb-phone, qb-phone, NPWD의 이벤트 이름에 스스로 응답하므로, 그 방식으로 메일, 문자, 알림을 보내는 스크립트는 계속 작동합니다. 다른 휴대폰의 export를 호출하는 스크립트는 한 곳만 바꾸면 됩니다:
exports.phone. 휴대폰 갈아타기를 참고하세요. - 자신의 서버 이벤트에서 실제
source를 전달하세요. 클라이언트 메시지에서 플레이어 ID를 가져와서는 안 됩니다. - 뱅킹, 차고, 주택, 디스패치는 시작할 때 선택되는 휴대폰의 브리지를 통해 연결됩니다. 직접 만든 스크립트를 제공자로 추가할 수도 있습니다: 고급 연동.
자주 묻는 질문
Pulse Phone 리소스의 이름은 무엇인가요?
phone입니다. 모든 export는 exports.phone:Name(...) 형태입니다. 다른 스크립트와 인벤토리의 아이템 훅이 이 이름으로 호출하므로 폴더 이름은 그대로 두세요.
lb-phone이나 qb-phone용으로 만든 스크립트가 Pulse Phone에서 작동하나요?
그 휴대폰들의 이벤트(메일, 문자, 알림, 전화번호)를 쓰는 스크립트는 수정 없이 작동합니다. 그 휴대폰의 export를 호출하는 스크립트는 대신 exports.phone을 써야 합니다.
Pulse Phone에 내가 만든 앱을 추가할 수 있나요?
네. 내 리소스에서 RegisterApp으로 등록하세요. 앱은 App Hub에 표시되며, 가이드에서 페이지, 권한, 알림을 다룹니다.