Pulse Phone 문서

Pulse Phone 개발자 API

Pulse Phone은 다른 리소스에 서버와 클라이언트 API를 제공합니다. 플레이어의 번호 읽기, 문자·메일·알림 보내기, 통화 걸기, 휴대폰에서 일어나는 일에 반응하기, 직접 만든 앱 추가가 가능합니다. 이 페이지의 내용은 모두 Pulse Phone 1.5.0의 phone 리소스를 기준으로 합니다. 모든 인자를 포함한 전체 목록은 Export와 이벤트에 있습니다.

Pulse Phone 1.5.2 기준4분 분량업데이트

API 위치

리소스 이름은 phone이므로 모든 호출은 exports.phone:... 형태입니다. 사용하기 전에 휴대폰이 준비되기를 기다리세요. IsReady()는 데이터베이스가 응답하고 휴대폰이 요청을 받을 수 있게 되면 true가 됩니다.

Lua
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? }) 해당 직업의 근무 중인 모든 구성원에게 보내는 알림. 몇 명에게 전달됐는지 반환한다

예: 강도 스크립트가 지도 핀과 함께 경찰에 알립니다.

Lua
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() 이 플레이어 본인의 휴대폰

예: 플레이어가 감옥에 있는 동안 휴대폰을 쓰지 못하게 합니다.

Lua
exports.phone:SetRestriction('myjail', 'block')   -- on entering the cell
exports.phone:SetRestriction('myjail', nil)       -- on release

State bag

서버는 다른 휴대폰 리소스가 쓰는 이름 그대로 이 값을 Player(src).state에 기록하므로, HUD와 디스패치 스크립트는 수정 없이 읽을 수 있습니다: phoneNumber, phoneOpen, inCall, onCallWith, phoneBattery, phoneDead. 클라이언트는 자신의 값을 LocalPlayer.state.phoneOpen으로 읽습니다.

config 예제

휴대폰 설정은 phone/config/에 있습니다. 다른 스크립트가 의존하는 세 가지입니다:

Lua
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에 표시되며, 가이드에서 페이지, 권한, 알림을 다룹니다.

영어에서 번역한 페이지입니다. 영어 페이지와 내용이 다르면 영어 페이지가 기준입니다. English