SocialService
Facilitates social functions that impact relationships made on the Roblox platform.
Memory category | Instances |
---|
Member index 26
Removed member index 11
History | Member | |
---|---|---|
602 | CanSendIrisInviteAsync(player: Instance): bool | |
602 | PromptIrisInvite(player: Instance, tag: string): null | |
282 | SetBestFriendUrl(bestFriendUrl: string): void | |
282 | SetFriendUrl(friendUrl: string): void | |
282 | SetGroupRankUrl(groupRankUrl: string): void | |
282 | SetGroupRoleUrl(groupRoleUrl: string): void | |
282 | SetGroupUrl(groupUrl: string): void | |
282 | SetPackageContentsUrl(stuffUrl: string): void | |
282 | SetStuffUrl(stuffUrl: string): void | |
602 | IrisInvitePromptClosed(player: Instance) | |
602 | OnIrisInviteInvoked(tag: string, irisParticipantIds: Array): Instance |
Description
SocialService facilitates social functions that impact relationships made on the Roblox platform. Its primary usage is to show invite prompts and the phone book to players, allowing them to send invitation requests to their friends through PromptGameInvite() and PromptPhoneBook() respectively. You may leverage signals when such requests are made.
History 68
- 677 Add ShowPromptRsvpToEvent
- 677 Change Parameters of PlayerPartyDataChanged from (partyId: string, isPartyDisabled: bool) to (partyId: string)
- 677 Change Parameters of UpdatePlayerPartyData from (partyId: string, isPartyDisabled: bool = false) to (partyId: string)
- 677 Add PromptRsvpToEventCompleted
- 677 Add PromptRsvpToEventAsync
- 677 Add GetEventRsvpStatusAsync
- 669 Change Parameters of PlayerPartyDataChanged from (partyId: string) to (partyId: string, isPartyDisabled: bool)
- 669 Change Parameters of UpdatePlayerPartyData from (partyId: string) to (partyId: string, isPartyDisabled: bool = false)
- 669 Add GetPartyAsync
- 666 Add UpdatePlayerPartyData
- 665 Add PlayerPartyDataChanged
- 665 Add GetPlayersByPartyId
- 602 Remove OnIrisInviteInvoked
- 602 Remove IrisInvitePromptClosed
- 602 Remove PromptIrisInvite
- 602 Remove CanSendIrisInviteAsync
- 600 Add OnCallInviteInvoked
- 600 Add PhoneBookPromptClosed
- 600 Add CallInviteStateChanged
- 600 Add PromptPhoneBook
- 600 Add CanSendCallInviteAsync
- 598 Change Parameters of InvokeIrisInvite from (player: Instance, tag: string, irisParticipantIds: Array) to (player: Instance, tag: string, irisParticipants: Array)
- 583 Add SelfViewVisible
- 583 Add SelfViewHidden
- 583 Add ShowSelfView
- 583 Add HideSelfView
- 580 Add
- 577 Add OnIrisInviteInvoked
- 577 Add PromptIrisInviteRequested
- 577 Add IrisInvitePromptClosed
- 577 Add PromptIrisInvite
- 577 Add InvokeIrisInvitePromptClosed
- 577 Add InvokeIrisInvite
- 577 Add CanSendIrisInviteAsync
- 573 Change ReturnType of PromptGameInvite from void to null
- 573 Change ReturnType of InvokeGameInvitePromptClosed from void to null
- 550 Change Parameters of PromptInviteRequested from (player: Instance) to (player: Instance, experienceInviteOptions: Instance)
- 550 Change Parameters of PromptGameInvite from (player: Instance) to (player: Instance, experienceInviteOptions: Instance = Instance)
- 549 Change Parameters of CanSendGameInviteAsync from (player: Instance) to (player: Instance, recipientId: int64 = 0)
- 462 Change ThreadSafety of PromptInviteRequested from to Unsafe
- 462 Change ThreadSafety of GameInvitePromptClosed from to Unsafe
- 462 Change ThreadSafety of PromptGameInvite from to Unsafe
- 462 Change ThreadSafety of InvokeGameInvitePromptClosed from to Unsafe
- 462 Change ThreadSafety of CanSendGameInviteAsync from to Unsafe
- 370 Add PromptInviteRequested
- 370 Add GameInvitePromptClosed
- 370 Add PromptGameInvite
- 370 Add InvokeGameInvitePromptClosed
- 370 Add CanSendGameInviteAsync
- 370 Add SocialService
- 282 Remove SocialService
- 281 Add SetStuffUrl
- 281 Add SetPackageContentsUrl
- 281 Add SetGroupUrl
- 281 Add SetGroupRoleUrl
- 281 Add SetGroupRankUrl
- 281 Add SetFriendUrl
- 281 Add SetBestFriendUrl
- 281 Add SocialService
- 282 Remove SocialService
- 69 Add SetGroupRoleUrl
- 69 Add SetGroupRankUrl
- 47 Add SetStuffUrl
- 47 Add SetPackageContentsUrl
- 47 Add SetGroupUrl
- 47 Add SetFriendUrl
- 47 Add SetBestFriendUrl
- 47 Add SocialService
Members 26
CallInviteStateChanged
Parameters (2) | |
---|---|
player | Instance |
inviteState | InviteState |
This event fires when a player's call invite state changes.
Thread safety | Unsafe |
---|
History 1
CanSendCallInviteAsync
Parameters (1) | ||
---|---|---|
player | Instance | |
Returns (1) | ||
bool |
Returns true
if the given Player can send a call invite to a
friend. You should always use the result of this method before calling
PromptPhoneBook() since the
ability to open the phone book may vary depending on the player.
See Roblox Connect for a sample implementation of this method.
Thread safety | Unsafe |
---|
History 1
CanSendGameInviteAsync
Parameters (2) | Default | |
---|---|---|
player | Instance | |
recipientId | int64 | 0 |
Returns (1) | ||
bool |
CanSendGameInviteAsync()
returns true
if the given Player can invite other players to the
current experience. You should always use the result of this method before
calling PromptGameInvite() since
the ability to invite players may vary depending on the platform or
player.
See Player Invite Prompts for more details on implementing player invite prompts, customizing prompts and notifications, and using launch data.
Thread safety | Unsafe |
---|
History 3
- 549 Change Parameters of CanSendGameInviteAsync from (player: Instance) to (player: Instance, recipientId: int64 = 0)
- 462 Change ThreadSafety of CanSendGameInviteAsync from to Unsafe
- 370 Add CanSendGameInviteAsync
GameInvitePromptClosed
Parameters (2) | |
---|---|
player | Instance |
recipientIds | Array |
This event fires when a player closes an invite prompt.
Thread safety | Unsafe |
---|
History 2
- 462 Change ThreadSafety of GameInvitePromptClosed from to Unsafe
- 370 Add GameInvitePromptClosed
GetEventRsvpStatusAsync
Parameters (1) | ||
---|---|---|
eventId | string | |
Returns (1) | ||
RsvpStatus |
Thread safety | Unsafe |
---|
History 1
GetPartyAsync
Parameters (1) | ||
---|---|---|
partyId | string | |
Returns (1) | ||
Array |
Returns an array of dictionaries containing data for all members
associated with the given partyId
. The returned array reflects the
current state of the party across all active server instances within the
experience and it is ordered by the time each party member accepted the
party invite. This means the first element in the array is the earliest to
accept and the last is the most recent.
This method is useful for retrieving up-to-date information about all party members currently in the experience and across different servers, enabling coordinated group behavior such as teleportation, matchmaking, or party-based gameplay logic.
Each dictionary in the returned array contains the following fields:
Key | Value Type | Description |
---|---|---|
UserId | number | The player's Player.UserId property. |
PlaceId | number | The DataModel.PlaceId of the place the party member is currently in. |
JobId | string | The DataModel.JobId of the server instance the user currently resides in. |
PrivateServerId | string | If applicable, the DataModel.PrivateServerId when the party member is in a private or reserved server. |
ReservedServerAccessCode | string | If applicable, the access code for the reserved server that the user currently resides in. Useful for teleporting party members to each other using TeleportService:TeleportAsync(). |
Note that this service does not work during playtesting in Roblox Studio; to test aspects of your experience using it, you must publish the experience and play it in the Roblox application.
Thread safety | Unsafe |
---|
History 1
- 669 Add GetPartyAsync
GetPlayersByPartyId
Parameters (1) | ||
---|---|---|
partyId | string | |
Returns (1) | ||
Instances |
Returns a table of all presently connected Player objects whose
Player.PartyId property matches the provided partyId
. This
method behaves similarly to Players:GetPlayers() but filters the
results to include only those players belonging to the specified party.
Note that this service does not work during playtesting in Roblox Studio; to test aspects of your experience using it, you must publish the experience and play it in the Roblox application.
Thread safety | Unsafe |
---|
History 1
HideSelfView
Parameters (0) | ||
---|---|---|
No parameters. | ||
Returns (1) | ||
null |
Hides the calling player's self view. If this method is called while the self view is already hidden, it does nothing.
Thread safety | Unsafe |
---|
History 1
- 583 Add HideSelfView
InvokeGameInvitePromptClosed
Parameters (2) | ||
---|---|---|
player | Instance | |
recipientIds | Array | |
Returns (1) | ||
null |
Security | RobloxScriptSecurity |
---|---|
Thread safety | Unsafe |
History 3
- 573 Change ReturnType of InvokeGameInvitePromptClosed from void to null
- 462 Change ThreadSafety of InvokeGameInvitePromptClosed from to Unsafe
- 370 Add InvokeGameInvitePromptClosed
InvokeIrisInvite
Parameters (3) | ||
---|---|---|
player | Instance | |
tag | string | |
irisParticipants | Array | |
Returns (1) | ||
null |
Security | RobloxScriptSecurity |
---|---|
Thread safety | Unsafe |
History 2
- 598 Change Parameters of InvokeIrisInvite from (player: Instance, tag: string, irisParticipantIds: Array) to (player: Instance, tag: string, irisParticipants: Array)
- 577 Add InvokeIrisInvite
InvokeIrisInvitePromptClosed
Parameters (1) | ||
---|---|---|
player | Instance | |
Returns (1) | ||
null |
Security | RobloxScriptSecurity |
---|---|
Thread safety | Unsafe |
History 1
OnCallInviteInvoked
Parameters (2) | ||
---|---|---|
tag | string | |
callParticipantIds | Array | |
Returns (1) | ||
Instance |
A callback to process when a call is placed from the phone book. The tag
parameter can be used to differentiate between different "entry points" or
similar, as described in
PromptPhoneBook(). Only one
callback can be set.
Thread safety | Unsafe |
---|
History 1
PhoneBookPromptClosed
Parameters (1) | |
---|---|
player | Instance |
Fires when a player closes the phone book prompt.
Thread safety | Unsafe |
---|
History 1
PlayerPartyDataChanged
Parameters (1) | |
---|---|
partyId | string |
Security | RobloxScriptSecurity |
---|---|
Thread safety | Unsafe |
History 3
- 677 Change Parameters of PlayerPartyDataChanged from (partyId: string, isPartyDisabled: bool) to (partyId: string)
- 669 Change Parameters of PlayerPartyDataChanged from (partyId: string) to (partyId: string, isPartyDisabled: bool)
- 665 Add PlayerPartyDataChanged
PromptGameInvite
Parameters (2) | Default | |
---|---|---|
player | Instance | |
experienceInviteOptions | Instance | Instance |
Returns (1) | ||
null |
PromptGameInvite() displays an invite prompt to the local player through which they may invite their friends to the current experience. Before calling this method, you should use CanSendGameInviteAsync() to determine whether the player can send an invite, as this ability may vary depending on the platform or player.
See Player Invite Prompts for more details on implementing invite prompts, customizing prompts and notifications, and using launch data.
Thread safety | Unsafe |
---|
History 4
- 573 Change ReturnType of PromptGameInvite from void to null
- 550 Change Parameters of PromptGameInvite from (player: Instance) to (player: Instance, experienceInviteOptions: Instance = Instance)
- 462 Change ThreadSafety of PromptGameInvite from to Unsafe
- 370 Add PromptGameInvite
PromptInviteRequested
Parameters (2) | |
---|---|
player | Instance |
experienceInviteOptions | Instance |
Security | RobloxScriptSecurity |
---|---|
Thread safety | Unsafe |
History 3
- 550 Change Parameters of PromptInviteRequested from (player: Instance) to (player: Instance, experienceInviteOptions: Instance)
- 462 Change ThreadSafety of PromptInviteRequested from to Unsafe
- 370 Add PromptInviteRequested
PromptIrisInviteRequested
Parameters (2) | |
---|---|
player | Instance |
tag | string |
Security | RobloxScriptSecurity |
---|---|
Thread safety | Unsafe |
History 1
PromptPhoneBook
Parameters (2) | ||
---|---|---|
player | Instance | |
tag | string | |
Returns (1) | ||
null |
Prompts the given Player with the phone book. If the player chooses to call someone, the CallInviteStateChanged event fires. You should use CanSendCallInviteAsync() prior to calling PromptPhoneBook() since the ability to see the phone book may vary depending on the player.
If a player is not eligible to open the phone book, an error dialog is shown.
See Roblox Connect for a sample implementation of this method.
Thread safety | Unsafe |
---|
History 1
- 600 Add PromptPhoneBook
PromptRsvpToEventAsync
Parameters (1) | ||
---|---|---|
eventId | string | |
Returns (1) | ||
RsvpStatus |
Thread safety | Unsafe |
---|
History 1
PromptRsvpToEventCompleted
Parameters (3) | ||
---|---|---|
eventId | string | |
success | bool | |
rsvpStatus | RsvpStatus | |
Returns (1) | ||
null |
Security | RobloxScriptSecurity |
---|---|
Thread safety | Unsafe |
History 1
SelfViewHidden
Parameters (0) | ||
---|---|---|
No parameters. |
Security | RobloxScriptSecurity |
---|---|
Thread safety | Unsafe |
History 1
- 583 Add SelfViewHidden
SelfViewVisible
Parameters (1) | |
---|---|
selfViewPosition | SelfViewPosition |
Security | RobloxScriptSecurity |
---|---|
Thread safety | Unsafe |
History 1
- 583 Add SelfViewVisible
ShowPromptRsvpToEvent
Parameters (1) | |
---|---|
eventId | string |
Security | RobloxScriptSecurity |
---|---|
Thread safety | Unsafe |
History 1
ShowSelfView
Parameters (1) | Default | |
---|---|---|
selfViewPosition | SelfViewPosition | LastPosition |
Returns (1) | ||
null |
Shows the calling player's self view. If this method is called while the self view is already visible, it does nothing.
Thread safety | Unsafe |
---|
History 1
- 583 Add ShowSelfView
UpdatePlayerPartyData
Parameters (1) | ||
---|---|---|
partyId | string | |
Returns (1) | ||
null |
Security | RobloxScriptSecurity |
---|---|
Thread safety | Unsafe |
History 3
- 677 Change Parameters of UpdatePlayerPartyData from (partyId: string, isPartyDisabled: bool = false) to (partyId: string)
- 669 Change Parameters of UpdatePlayerPartyData from (partyId: string) to (partyId: string, isPartyDisabled: bool = false)
- 666 Add UpdatePlayerPartyData
Removed members 11
CanSendIrisInviteAsync
Parameters (1) | ||
---|---|---|
player | Instance | |
Returns (1) | ||
bool |
Thread safety | Unsafe |
---|
History 2
- 602 Remove CanSendIrisInviteAsync
- 577 Add CanSendIrisInviteAsync
IrisInvitePromptClosed
Parameters (1) | |
---|---|
player | Instance |
Thread safety | Unsafe |
---|
History 2
- 602 Remove IrisInvitePromptClosed
- 577 Add IrisInvitePromptClosed
OnIrisInviteInvoked
Parameters (2) | ||
---|---|---|
tag | string | |
irisParticipantIds | Array | |
Returns (1) | ||
Instance |
Thread safety | Unsafe |
---|
History 2
- 602 Remove OnIrisInviteInvoked
- 577 Add OnIrisInviteInvoked
PromptIrisInvite
Parameters (2) | ||
---|---|---|
player | Instance | |
tag | string | |
Returns (1) | ||
null |
Thread safety | Unsafe |
---|
History 2
- 602 Remove PromptIrisInvite
- 577 Add PromptIrisInvite
SetBestFriendUrl
Parameters (1) | ||
---|---|---|
bestFriendUrl | string | |
Returns (1) | ||
void |
Security | LocalUserSecurity |
---|
History 4
- 282 Remove SocialService
- 281 Add SetBestFriendUrl
- 282 Remove SocialService
- 47 Add SetBestFriendUrl
SetFriendUrl
Parameters (1) | ||
---|---|---|
friendUrl | string | |
Returns (1) | ||
void |
Security | LocalUserSecurity |
---|
History 4
- 282 Remove SocialService
- 281 Add SetFriendUrl
- 282 Remove SocialService
- 47 Add SetFriendUrl
SetGroupRankUrl
Parameters (1) | ||
---|---|---|
groupRankUrl | string | |
Returns (1) | ||
void |
Security | LocalUserSecurity |
---|
History 4
- 282 Remove SocialService
- 281 Add SetGroupRankUrl
- 282 Remove SocialService
- 69 Add SetGroupRankUrl
SetGroupRoleUrl
Parameters (1) | ||
---|---|---|
groupRoleUrl | string | |
Returns (1) | ||
void |
Security | LocalUserSecurity |
---|
History 4
- 282 Remove SocialService
- 281 Add SetGroupRoleUrl
- 282 Remove SocialService
- 69 Add SetGroupRoleUrl
SetGroupUrl
Parameters (1) | ||
---|---|---|
groupUrl | string | |
Returns (1) | ||
void |
Security | LocalUserSecurity |
---|
History 4
- 282 Remove SocialService
- 281 Add SetGroupUrl
- 282 Remove SocialService
- 47 Add SetGroupUrl
SetPackageContentsUrl
Parameters (1) | ||
---|---|---|
stuffUrl | string | |
Returns (1) | ||
void |
Security | LocalUserSecurity |
---|
History 4
- 282 Remove SocialService
- 281 Add SetPackageContentsUrl
- 282 Remove SocialService
- 47 Add SetPackageContentsUrl
SetStuffUrl
Parameters (1) | ||
---|---|---|
stuffUrl | string | |
Returns (1) | ||
void |
Security | LocalUserSecurity |
---|
History 4
- 282 Remove SocialService
- 281 Add SetStuffUrl
- 282 Remove SocialService
- 47 Add SetStuffUrl