SocialService

Phương Pháp

HideSelfView():void
Ẩn tầm nhìn của người chơi tự.
PromptGameInvite(player : Instance,experienceInviteOptions : Instance):void
Yêu cầu người này Player với màn hình mời.
PromptPhoneBook(player : Instance,tag : string):void
Yêu cầu Player đã được cung cấp với cuộn sách.
ShowSelfView(selfViewPosition : Enum.SelfViewPosition):void
Hiển thị tầm nhìn của người chơi tại chỗ.
CanSendCallInviteAsync(player : Instance):bool
Sinh Lợi
Chỉ ra whether the given Player can invite other players to a call.
CanSendGameInviteAsync(player : Instance,recipientId : number):bool
Sinh Lợi
Chỉ ra whether the given Player can invite other players.

Sự Kiện

CallInviteStateChanged(player : Instance,inviteState : Enum.InviteState):RBXScriptSignal
Kích hoạt khi trạng thái mời của một người chơi thay đổi.
GameInvitePromptClosed(player : Instance,recipientIds : Array):RBXScriptSignal
Lửa khi một người chơi đóng cái mời.
PhoneBookPromptClosed(player : Instance):RBXScriptSignal
Lửa khi một người chơi đóng các lệnh của cuộn sách điện thoại.

Gọi Lại

OnCallInviteInvoked(tag : string,callParticipantIds : Array):Instance

Thuộc Tính

Phương Pháp

HideSelfView

void

Ẩn mặt người chơi tự xem. Nếu phương thức này được gọi khi mặt người chơi đã ẩn, nó không làm gì.

Lợi Nhuận

void

PromptGameInvite

void

PromptGameInvite() hiển thị một mời khuyến dụng đến người chơi địa phương thông qua đó họ có thể mời bạn bè của họ vào trải nghiệm hiện tại. Trước khi gọi phương

Xem mời người chơi thông báo để biết thêm chi tiết về cách thực hiện lời mời, tùy chỉnh lời mời và thông báo và sử dụng dữ liệu khởi động.

Tham Số

player: Instance

The Player to prompt with the invite popup.

experienceInviteOptions: Instance

Ống chuẩn ExperienceInviteOptions cho phép tùy chỉnh thông báo.

Giá Trị Mặc Định: "nil"

Lợi Nhuận

void

Mẫu mã

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

Yêu cầu người chơi Player với cuộn sách. Nếu người chơi chọn gọi ai đó, sự kiện CallInviteStateChanged sẽ b

Nếu một người chơi không đủ điều kiện để mở cuộn sách điện thoại, một hội thoại lỗi được hiển thị.

Xem Roblox Connect để có một ví dụ thực hiện phương pháp này.

Tham Số

player: Instance

Người chơi để yêu cầu với cuộn sách điện thoại.

tag: string

Chuỗi để giúp phân biệt giữa các điểm dữ liệu điện thoại khác nhau hoặc tương tự. Ví dụ, bạn có thể gửi một chuỗi xác định vùng mà người chơi gọi hiện đang ở.

Lợi Nhuận

void

Mẫu mã

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

Hiển thị tầm nhìn của người chơi tự. Nếu phương thức này được gọi khi tầm nhìn đã hiển thị, nó không làm gì.

Tham Số

selfViewPosition: Enum.SelfViewPosition

Vị trí để đặt self view.

Giá Trị Mặc Định: "LastPosition"

Lợi Nhuận

void

CanSendCallInviteAsync

Sinh Lợi

Trả lại true nếu Player đã có thể gửi một lời mời gọi đến một người bạn bè. Bạn luôn nên sử dụng kết quả của phương thức này trước khi gọi PromptPhoneBook() vì khả năng mở

Xem Roblox Connect để có một ví dụ thực hiện phương pháp này.

Tham Số

player: Instance

Các Player instance của người chơi có thể gửi mời gọi.

Lợi Nhuận

Whether the specified player can send a lời mời cuộc gọi.

Mẫu mã

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

Sinh Lợi

CanSendGameInviteAsync() 반환 true 如果 đã được đưa Player có thể mời người chơi khác vào trải nghiệm hiện tại. Bạ

Xem mời người chơi thông báo để biết thêm chi tiết về cách thực hiện lời mời người chơi, tùy chỉnh lời mời và thông báo và sử dụng dữ liệu khởi động.

Tham Số

player: Instance

Câu Player của người chơi có thể gửi một lời mời.

recipientId: number

Tùy chọn Player.UserId của nhận đường dẫn đến, được sử dụng để kiểm tra xem có thể mời đối tượng người nhậnđó không.

Giá Trị Mặc Định: 0

Lợi Nhuận

Whether the specified player can send an invite.

Mẫu mã

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

Sự Kiện

CallInviteStateChanged

Sự kiện này bắt đầu khi trạng thái mời của một người chơi thay đổi.

Tham Số

player: Instance

Instância Player của người chơi có trạng thái mời gọi cuộc gọi.

inviteState: Enum.InviteState

Tình trạng mời gọi mới.

Mẫu mã

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

Sự kiện này bắt đầu khi một người chơi đóng cái mời.

Tham Số

player: Instance

Class.Player từ người chơi đã đóng cái khẩn cầu.

recipientIds: Array

Không còn được populated; một阵 bị rỗi.

PhoneBookPromptClosed

Lửa khi một người chơi đóng các lệnh của cuộn sách điện thoại.

Tham Số

player: Instance

Cây Player của người chơi đóng sách điện thoại.