SocialService

메서드

HideSelfView():void
호출 플레이어의 자신 뷰를 숨깁니다.
PromptGameInvite(player : Instance,experienceInviteOptions : Instance):void
초대 화면과 함께 지정된 Player에 초대합니다.
PromptPhoneBook(player : Instance,tag : string):void
전화 책으로 지정된 Player 에 대한 메시지를 표시합니다.
ShowSelfView(selfViewPosition : Enum.SelfViewPosition):void
호출 플레이어의 셀프 뷰를 표시합니다.
CanSendCallInviteAsync(player : Instance):bool
생성
지정한 Player 가 다른 플레이어를 전화에 초대할 수 있는지 여부를 나타냅니다.
CanSendGameInviteAsync(player : Instance,recipientId : number):bool
생성
다른 플레이어를 초대할 수 있는지 여부를 나타냅니다. Player

이벤트

CallInviteStateChanged(player : Instance,inviteState : Enum.InviteState):RBXScriptSignal
플레이어의 초대 상태가 변경될 때 발생합니다.
GameInvitePromptClosed(player : Instance,recipientIds : Array):RBXScriptSignal
플레이어가 초대 프롬프트를 닫을 때 화재됩니다.
PhoneBookPromptClosed(player : Instance):RBXScriptSignal
플레이어가 전화 책 프롬프트를 닫을 때 화재됩니다.

콜백

OnCallInviteInvoked(tag : string,callParticipantIds : Array):Instance
전화 목록에서 전화를 받을 때의 콜백.

속성

메서드

HideSelfView

void

호출 플레이어의 자신 뷰를 숨깁니다. 이 메서드를 호출하면 자신 뷰가 이미 숨겨져 있더라도 작동하지 않습니다.

반환

void

PromptGameInvite

void

PromptGameInvite() 는 로컬 플레이어를 통해 친구를 현재 경험에 초대하도록 하는 초대 프롬프트를 표시합니다. 이 메서드를 호출하기 전에 Class.SocialService:CanSendGameInviteAsync()|CanSendGameInviteAsync

초대 프롬프트 구현, 사용자 지정 프롬프트 사용 및 시작 데이터 사용에 대한 자세한 내용은 Player Invite Prompts를 참조하십시오.

매개 변수

player: Instance

Class.Player 를 클릭하여 초대 팝업을 표시합니다.

experienceInviteOptions: Instance

프롬프트를 사용자 정의하기 위한 옵션 ExperienceInviteOptions 개체.

기본값: "nil"

반환

void

코드 샘플

The following code sample uses CanSendGameInviteAsync() to confirm whether the local Player can send an invite. If true, it then prompts the invite using PromptGameInvite().

Sending an Invite

local SocialService = game:GetService("SocialService")
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Function to check whether the player can send an invite
local function canSendGameInvite(sendingPlayer)
	local success, canSend = pcall(function()
		return SocialService:CanSendGameInviteAsync(sendingPlayer)
	end)
	return success and canSend
end

local canInvite = canSendGameInvite(player)
if canInvite then
	SocialService:PromptGameInvite(player)
end

PromptPhoneBook

void

플레이어가 전화 책을 선택하면 Player 에 대한 지정된 전화기 책을 전송합니다. 플레이어가 누군가를 전화하기로 선택하면 Class.SocialService.CallInviteState

플레이어가 전화 책을 열 자격이 없으면 오류 대화 상자가 표시됩니다.

이 메서드의 샘플 구현은 Roblox Connect에 참조하십시오.

매개 변수

player: Instance

전화 책을 가진 플레이어가 메시지를 표시합니다.

tag: string

다양한 전화 책 항목 또는 유사한 항목을 구별하는 데 사용되는 문자열입니다. 예를 들어, 호출 플레이어의 캐릭터가 현재 어떤 지역에 있는지 정의하는 문자열을 전달할 수 있습니다.

반환

void

코드 샘플

The following code sample, placed within a child LocalScript of a GuiButton, uses CanSendCallInviteAsync() to confirm that the player can make a call. If so, it connects PromptPhoneBook() to the button's Activated event.

SocialService:PromptPhoneBook()

local Players = game:GetService("Players")
local SocialService = game:GetService("SocialService")

local player = Players.LocalPlayer
local button = script.Parent
button.Visible = false

-- Function to check whether the player can send a call invite
local function canSendCallingInvite(sendingPlayer)
	local success, canSend = pcall(function()
		return SocialService:CanSendCallInviteAsync(sendingPlayer)
	end)
	return success and canSend
end

local canCall = canSendCallingInvite(player)
if canCall then
	button.Visible = true
	button.Activated:Connect(function()
		SocialService:PromptPhoneBook(player, "")
	end)
end

ShowSelfView

void

호출 플레이어의 자신 뷰를 표시합니다. 자신 뷰가 이미 표시되어 있는 경우이 메서드를 호출하면 아무것도 하지 않습니다.

매개 변수

selfViewPosition: Enum.SelfViewPosition

자신의 뷰를 배치할 위치입니다.

기본값: "LastPosition"

반환

void

CanSendCallInviteAsync

생성

Class.Player 가 친구에게 전화 초대를 보낼 수 있는지 반환합니다. Player 을 호출하기 전에 이 메서드의 결과를 항상 사용해야 합니다. 플레이어에 따라 PromptPhoneBook() 을 열 수 있는

이 메서드의 샘플 구현은 Roblox Connect에 참조하십시오.

매개 변수

player: Instance

플레이어가 콜 초대를 보낼 수 있는 Player 인스턴스.

반환

지정된 플레이어가 호출 초대를 보낼 수 있는지 여부.

코드 샘플

SocialService:PromptPhoneBook()

local Players = game:GetService("Players")
local SocialService = game:GetService("SocialService")

local player = Players.LocalPlayer
local button = script.Parent
button.Visible = false

-- Function to check whether the player can send a call invite
local function canSendCallingInvite(sendingPlayer)
	local success, canSend = pcall(function()
		return SocialService:CanSendCallInviteAsync(sendingPlayer)
	end)
	return success and canSend
end

local canCall = canSendCallingInvite(player)
if canCall then
	button.Visible = true
	button.Activated:Connect(function()
		SocialService:PromptPhoneBook(player, "")
	end)
end

CanSendGameInviteAsync

생성

CanSendGameInviteAsync() 는 주어진 true 가 다른 플레이어를 현재 경험에 초대할 수 있는지 여부에 대해 Player 를 반환합니다. 항상 이 메서드

플레이어 초대 프롬프트를 구현하는 방법에 대한 자세한 내용은 플레이어 초대 프롬프트 를 참조하십시오.

매개 변수

player: Instance

플레이어가 초대를 보낼 수 있는 Player 인스턴스.

recipientId: number

Class.Player.UserId 는 수신자가 해당 발신자를 초대할 수 있는지 여부를 확인하는 데 사용됩니다.

기본값: 0

반환

지정된 플레이어가 초대를 보낼 수 있는지 여부.

코드 샘플

The following code sample uses CanSendGameInviteAsync() to confirm whether the local Player can send an invite. If true, it then prompts the invite using PromptGameInvite().

Sending an Invite

local SocialService = game:GetService("SocialService")
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Function to check whether the player can send an invite
local function canSendGameInvite(sendingPlayer)
	local success, canSend = pcall(function()
		return SocialService:CanSendGameInviteAsync(sendingPlayer)
	end)
	return success and canSend
end

local canInvite = canSendGameInvite(player)
if canInvite then
	SocialService:PromptGameInvite(player)
end

이벤트

CallInviteStateChanged

이 이벤트는 플레이어의 초대 상태가 변경될 때 발생합니다.

매개 변수

player: Instance

콜 초대 상태 변경을 가진 플레이어의 Player 인스턴스.

inviteState: Enum.InviteState

새로운 호출 초대 상태입니다.

코드 샘플

SocialService.CallInviteStateChanged

local SocialService = game:GetService("SocialService")

local button = script.Parent
local isPhonebookOpen = false

SocialService.CallInviteStateChanged:Connect(function(_, inviteState)
	local isCalling = inviteState == Enum.InviteState.Placed

	if isCalling or isPhonebookOpen then
		button.Visible = false
	else
		button.Visible = true
	end
end)

GameInvitePromptClosed

이 이벤트는 플레이어가 초대 프롬프트를 닫을 때 발생합니다.

매개 변수

player: Instance

플레이어가 프롬프트를 닫은 플레이어의 Player 인스턴스.

recipientIds: Array

더 이상 채워지지 않습니다; 빈 배열입니다.

PhoneBookPromptClosed

플레이어가 전화 책 프롬프트를 닫을 때 화재됩니다.

매개 변수

player: Instance

휴대폰 책을 닫은 플레이어의 Player 인스턴스.