Spieler-Einladungsaufforderungen

Zusätzlich zu den üblichen Förderungs-Methoden, um deine Spielerbasis zu vergrößern, kannst du Einladungsaufforderungen direkt in deinem Erlebnis implementieren, um Spieler dazu zu bringen, ihre Freunde einzuladen und das gemeinsame Gameplayzu vergrößern.

Das Einladungssystem bietet gefolgte Profile:

• Dynamische Einladende — Fordere Spieler auf, mehrere Freunde aus einer Auswahlliste einzuladen oder einen bestimmten Freund:ineinzuladen.
• Startdaten — Enthält optionale Startdaten , die gelesen werden können, wenn sich der eingeladene Freund anschließt.Beispiele für Anwendungsfälle umfassen die routierung eingeladener Freunde an einen Koordinatenstandort oder die Personalisierung der Beitrittserfahrung für den Empfänger.
• Anpassbarer Text — Passen Sie die Einladungsaufforderung-Nachricht und die Benachrichtigungsnachricht an.Zum Beispiel kann eine Einladungsaufforderung für den Spieler lesen "Frage deine Freunde, dem Abenteuer beizutreten!", und die Benachrichtigungsnachricht für die eingeladenen Freund:inkann lesen "displayName möchte, dass du ihrem Abenteuer in experienceName beitrittst!".

Du kannst auch Empfänger und Einladende verfolgen und belohnen, indem du das Freund-Einladungs-Belohnungssystem verwendest.

Ladeoptionen einstellen

Standardmäßig zeigt eine Einladungsaufforderung für den Spieler ein Menü mit Freunden mit Einladen -Buttons.Um die Nachrichtanzupassen, einen bestimmten Freund:inanzuzielen oder Startdaten in die Einladung einzufügen, musst du ein ExperienceInviteOptions Objekt mit den gewünschten Eigenschaften einrichten.

LocalScript - Lade mehrere Freunde ein
local SocialService = game:GetService("SocialService")
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Erstelle Einladungsoptionen mit einer benutzerdefinierten Nachricht
local inviteOptions = Instance.new("ExperienceInviteOptions")
inviteOptions.PromptMessage = "Ask your friends to join the adventure!"

Benachrichtigungsoptionen festlegen

Standardmäßig enthält die Einladungsbenachrichtigung, die Freunde erhalten, die DisplayName des Absenders, den Benutzernamen und den Namen der Erfahrung.Um die Nachricht anzupassen, kannst du ein Benachrichtigungs -Asset auf dem Creator-Dashboard erstellen und seine Asset-ID als einen Parameter von ExperienceInviteOptions einfügen.

1. Navigiere zum Creator-Dashboard.

2. Ähnlich wie Abzeichen, sind Benachrichtigungsstränge an ein bestimmtes Erlebnis gebunden. Lokalisieren Sie das Thumbnail dieses Erlebnisses und klicken Sie darauf.

3. In der linken Spalte, unter Beteiligung , klicken Sie auf Benachrichtigungen .

4. Klicke in der mittleren Region auf die Schaltfläche Erstelle eine Benachrichtigungsstring .

5. Füllen Sie einen Identifikationsnamen (nur für Sie sichtbar) und den benutzerdefinierten Benachrichtigungstext aus.Beachte, dass du experienceName als Platzhalter einfügen musst, um den Namen der Erlebnisfür eingeladene Freunde zu identifizieren, und du kannst optional den Namen des Absenders DisplayName durch den Platzhalter displayName einfügen.

   Beispielfernmeldezeilen:

   • displayName möchte, dass du an ihrem Abenteuer in experienceName teilnimmst!
   • displayName hat gerade die sechste Stufe von experienceName abgeschlossen. Können Sie?

6. Wenn du bereit bist, klicke auf die Schaltfläche Erstellungsbenachrichtigungsstring .

7. Auf der Seite mit den Benachrichtigungen, in der Tabelle der Benachrichtigungen, klicke auf die Schaltfläche ⋯ in der Spalte Aktionen und wähle Kopiere Asset-ID .

8. Im ExperienceInviteOptions Objekt für die Einladungsaufforderung füge die Asset-ID als Wert der InviteMessageId Eigenschaftenein.

   LocalScript - Lade mehrere Freunde ein
   local SocialService = game:GetService("SocialService")
   local Players = game:GetService("Players")
   
   local player = Players.LocalPlayer
   
   -- Baue Einladungsoptionen mit der Benutzer-ID des Freund:in
   local inviteOptions = Instance.new("ExperienceInviteOptions")
   inviteOptions.InviteMessageId = "ef0e0790-e2e8-4441-9a32-93f3a5783bf1"

Lade zu einer Einladung ein

Um eine Einladung auszulösen, solltest du zuerst feststellen, ob der Spieler kann eine Einladung senden, da die Fähigkeit je nach Plattform oder Spieler:invariieren kann.Sobald bestätigt, kannst du die Einladungsaufforderung an den Spieler:inanzeigen.

1. Rufen Sie SocialService:CanSendGameInviteAsync() an, eingepackt in eine pcall() da es sich um eine asynchrone Netzanruf handelt, der gelegentlich fehlschlagen kann.
2. Wenn die Einladungsfähigkeit bestätigt wird, rufe SocialService:PromptGameInvite() mit dem optionalen Einladungsoptionen-Objekt als zweites Argument auf.

Sobald der Spieler dazu aufgefordert wird, sieht er eine Eingabeaufforderung auf dem Bildschirm, um mehrere Freunde einzuladen oder den spezifischen Freund, der in den Einladungsoptionen-Objekt definiert ist.Wenn der Spieler dann auf die Schaltfläche Einladen für einen oder mehrere Freunde klickt, erhalten diese Freunde eine Benachrichtigung mit der DisplayName des Absenders, dem Benutzernamen und dem Erlebnissenamen.Benachrichtigungen können weiter angepasst werden, wie in Benachrichtigungsoptionen festlegen beschrieben.

LocalScript - Lade mehrere Freunde ein
local SocialService = game:GetService("SocialService")
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Funktion, um zu überprüfen, ob der Spieler eine Einladung senden kann
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

Startdaten einfügen

Um die In-Experience-Zusammenarbeit weiter zu verbessern oder Spieler-Einladungen zu fördern, kannst du Startdaten in einem Einladungsfenster einfügen, das für Szenarien wie das Routing eingeladener Freunde an einen Koordinatenstandort oder die Personalisierung der Beitrittserfahrung für den Empfänger nützlich ist.

1. Wenn du eine Einladung anfragst, füge ein ExperienceInviteOptions Objekt mit relevanten Daten hinzu, die verwendet werden, wenn der Freund der Erlebnisbeitritt, zum Beispiel das Player.UserId des Absenders, die ID eines Abzeichens zur Verleihung an den Freund beim Beitritt oder eine Koordinatenposition, um den Freund zu spawnen.Wenn Sie mehrere Datenstücke kompilieren müssen, verschlüsseln Sie die Daten mit JSONEncode().

   Mehrere FreundeBestimmter Freund

   LocalScript - Lade mehrere Freunde ein
   local HttpService = game:GetService("HttpService")
   local SocialService = game:GetService("SocialService")
   local Players = game:GetService("Players")
   
   local player = Players.LocalPlayer
   
   local data = {
   	senderUserID = player.UserId,
   	spawnLocation = {12, 48, 205.5}
   }
   
   local launchData = HttpService:JSONEncode(data)
   
   -- Baue Einladungsoptionen mit Startdaten auf
   local inviteOptions = Instance.new("ExperienceInviteOptions")
   inviteOptions.LaunchData = launchData
   
   -- Funktion, um zu überprüfen, ob der Spieler eine Einladung senden kann
   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, inviteOptions)
   end

   Denken Sie immer daran, inviteOptions mit den Startdaten (maximal 200 Zeichen) als zweiter Parameter von PromptGameInvite() einzuschließen.

2. Für eingehende Freunde, die sich über die Benachrichtigungenanmelden, überprüfe die Startdaten auf der Serverseite durch Player:GetJoinData() .Wenn du mehrere Datenstücke in JSON für die Einladungsaufforderung codierst, denke daran, sie mit JSONDecode() zu dekodieren.

   Skript - Verwendung von Einladungsstartdaten
   local HttpService = game:GetService("HttpService")
   local Players = game:GetService("Players")
   
   local ATTEMPT_LIMIT = 10
   local RETRY_DELAY = 1
   
   local function onPlayerAdded(player)
   	local launchData
   
   	for _ = 1, ATTEMPT_LIMIT do
   		task.wait(RETRY_DELAY)
   		local joinData = player:GetJoinData()
   		if joinData.LaunchData ~= "" then
   			launchData = joinData.LaunchData
   			break
   		end
   	end
   
   	if launchData then
   		local data = HttpService:JSONDecode(launchData)
   		print(data.senderUserID)
   		print(data.spawnLocation)
   	else
   		warn("No launch data received!")
   	end
   end
   
   Players.PlayerAdded:Connect(onPlayerAdded)

   Die Startdaten können einige Sekunden dauern, bis sie nach dem Beitritt des Freundes aus der Einladung erscheinen.Wie im Codebeispiel oben gezeigt, wird empfohlen, bis die Startdaten angekommen sind, zu warten, bevor du versuchst, es zu verwenden.

3. Wenn die Startdaten vorliegen, können Sie sie für eine Vielzahl von Designszenarien verwenden, einschließlich:

   • Spawne den eingehenden Freund am Beginn eines herausfordernden Hinderniskurses, den der Absender gerade abgeschlossen hat, basierend auf einer Koordinatenposition, die durch die Startdaten übermittelt wurde.
   • Überprüfe, ob der Absender an der Ortist, basierend auf seinen Player.UserId in den Startdaten, und teleportiere den Charakter des Freund:inin der Nähe seines Charakters.