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

코드 샘플

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

코드 샘플

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

반환

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

코드 샘플

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 인스턴스.