Phone - Events

Phone events for data updates, notifications, and state changes

Phone events allow resources to react to phone state changes, data updates, and notification events.

Server Events

Phone:Server:RegisterMiddleware

Fired when the phone registers middleware handlers.

AddEventHandler('Phone:Server:RegisterMiddleware', function()
    -- Register phone-related middleware
end)

---

Phone:Server:RegisterCallbacks

Fired when the phone registers server callbacks.

AddEventHandler('Phone:Server:RegisterCallbacks', function()
    -- Register phone-related callbacks
end)

---

Phone:Server:AliasUpdated

Fired when a player updates an app alias.

AddEventHandler('Phone:Server:AliasUpdated', function(source, app, alias)
    -- Handle alias change
end)

---

Phone:Server:UIReset

Fired when the phone UI resets.

AddEventHandler('Phone:Server:UIReset', function(source)
    -- Handle UI reset
end)

---

Client Events

Phone:Client:SetData

Sent from server to set phone data on the client.

AddEventHandler('Phone:Client:SetData', function(key, data)
    -- Phone data was set
end)

---

Phone:Client:AddData

Sent from server to add data to the phone.

AddEventHandler('Phone:Client:AddData', function(type, data, key)
    -- Data was added
end)

---

Phone:Client:UpdateData

Sent from server to update phone data.

AddEventHandler('Phone:Client:UpdateData', function(type, id, data)
    -- Data was updated
end)

---

Phone:Client:RemoveData

Sent from server to remove phone data.

AddEventHandler('Phone:Client:RemoveData', function(key, id)
    -- Data was removed
end)

---

Phone:Client:ResetData

Sent from server to reset all phone data.

AddEventHandler('Phone:Client:ResetData', function()
    -- All phone data was reset
end)

---

Phone:Client:Notifications:Add

Sent from server to add a notification.

AddEventHandler('Phone:Client:Notifications:Add', function(title, description, time, duration, app, actions, notifData)
    -- Notification received
end)

---

Phone:Client:Notifications:AddWithId

Sent from server to add a tracked notification.

AddEventHandler('Phone:Client:Notifications:AddWithId', function(id, title, description, time, duration, app, actions, notifData)
    -- Tracked notification received
end)

---

Phone:Client:Notifications:Update

Sent from server to update an existing notification.

AddEventHandler('Phone:Client:Notifications:Update', function(id, title, description)
    -- Notification updated
end)

---

Phone:Client:Notifications:Remove

Sent from server to remove a notification.

AddEventHandler('Phone:Client:Notifications:Remove', function(id)
    -- Notification removed
end)

---

Phone:Client:Close

Sent from server to close the phone.

AddEventHandler('Phone:Client:Close', function()
    -- Phone was closed by server
end)

---

Phone:Client:ReceiveShare

Sent when the player receives shared data (contact, document, etc.).

AddEventHandler('Phone:Client:ReceiveShare', function(data)
    -- Handle received share
end)

---

Server Callbacks

These callbacks are used by the phone UI to communicate with the server.

Callback	Description
Phone:Apps:Home	Manage home screen apps (add/remove)
Phone:Apps:Dock	Manage dock apps (add/remove)
Phone:Apps:Reorder	Reorder apps on home/dock
Phone:UpdateAlias	Update app alias
Phone:ShareMyContact	Share contact with nearby players
Phone:Permissions	Check phone permissions
Phone:Gallery:GetUploadURL	Get upload URL for photos
Phone:Gallery:SavePhoto	Save photo to gallery
Phone:Messages:GetBurnerMessages	Get burner phone messages

---

Middleware Events

Characters:Spawning

The phone hooks into character spawning to initialize phone data.

-- Internally, the phone registers middleware on Characters:Spawning
-- This initializes: apps, settings, permissions, aliases, job data
Middleware:Add('Characters:Spawning', function(source, character)
    -- Phone initialization happens here
end)

Characters:Creating

The phone hooks into character creation to set up default phone data.

-- Default phone data created for new characters:
-- Apps = { installed = {}, home = {}, dock = {} }
-- PhoneSettings = { wallpaper, ringtone, texttone, colors, zoom, volume, notifications }
-- PhonePermissions = { redline = { create = false } }
-- PhoneType = "android"

---

Next Steps

Phone - Exports

Phone API methods

Phone - Apps

App configuration

Middleware API

Middleware system