Freigeben über

Grundlegendes zur Funktionsweise des PlayFab Party-Chats

  • Artikel

Mit PlayFab Party können Sie Ihrem Spiel ganz einfach Sprach- und Textkommunikation hinzufügen.

PlayFab Party-Chat ist:

  • Flexibel: Bietet Ihnen die vollständige Kontrolle darüber, wie Ihr Spieler kommunizieren soll.
  • Leistungsstark: Verwendet hardwarebasierte Codecbeschleunigung auf unterstützten Plattformen.
  • Barrierefrei: Unterstützt von Azure Cognitive Services sind die Features für Die Spracherkennung, die Sprachsynthese und die Übersetzung integriert und einfach zu aktivieren.
  • Effizient: Wenn Ihr Chatsystem eng in Ihre Netzwerkebene integriert ist, werden Sprachdaten so effizient wie möglich dorthin gesendet, wo sie hinzukommen müssen.

Chatgrundlagen

Um Ihrem Spiel Sprach- und Textkommunikation hinzuzufügen, müssen Sie zunächst ein PartyLocalChatControl -Objekt erstellen. Dieses PartyLocalChatControl Objekt fungiert als Verwaltungsobjekt für Chatvorgänge, die sich auf einen bestimmten lokalen Benutzer beziehen, sodass Sie das Eingabe- und Ausgabegerät, den Stummschaltungsstatus und die Barrierefreiheitseinstellungen auswählen können. Jeder lokale Benutzer kann nicht mehr als ein Chatsteuerelement haben. Damit ein lokales Chat-Steuerelement mit einem anderen Chatsteuerelement kommunizieren kann, müssen die folgenden Anforderungen erfüllt sein:

  1. Die beiden Chatsteuerelemente müssen sich im gleichen Netzwerk befinden.
  2. Die Chatberechtigungen zwischen den beiden Chatsteuerelementen müssen die Audio- und/oder Textkommunikation zulassen.

Mit Ihrem lokalen Chat-Steuerelement können Sie jetzt eine Verbindung mit einem Netzwerk herstellen, indem Sie aufrufen PartyNetwork::ConnectChatControl(). Bei der Verbindung werden andere Geräte im Netzwerk benachrichtigt, dass Ihre Chatsteuerung mit einer PartyChatControlJoinedNetworkStateChange Zustandsänderung dem Netzwerk beigetreten ist. Sie erhalten auch für PartyChatControlJoinedNetworkStateChange jede andere Chatsteuerung, die sich bereits im Netzwerk befindet, und können sofort mit ihnen kommunizieren.

Audioeingaben und -ausgaben

Party ermöglicht Es Ihnen, mit den PartyLocalChatControl::SetAudioInput() Methoden und PartyLocalChatControl::SetAudioOutput() auszuwählen, welche Audiogeräte von Ihrem Chat-Steuerelement verwendet werden. Verwenden Sie die PartyAudioDeviceSelectionType Enumeration, um das Verhalten dieser Methoden zu ändern:

PartyAudioDeviceSelectionType::None

Wenn dieser Audiogeräteauswahltyp ausgewählt wird, verwendet das Chatsteuerelement kein Audiogerät. Dieser Audiogeräteauswahltyp ist die Standardeinstellung.

PartyAudioDeviceSelectionType::SystemDefault

Wenn dieser Audiogeräteauswahltyp ausgewählt wird, versucht das Chatsteuerelement, das Standardkommunikationsgerät des Systems zu verwenden. Unter Windows kann der Player dieses Gerät jederzeit über die Windows Sound-Systemsteuerung ändern, und die Partei reagiert automatisch auf diese Änderungen. Dieser Auswahltyp wird auf Xbox One nicht unterstützt und im Allgemeinen nicht empfohlen, wenn mehrere lokale Benutzer gleichzeitig am Chat teilnehmen.

PartyAudioDeviceSelectionType::PlatformUserDefault

Wenn dieser Audiogeräteauswahltyp ausgewählt wird, PartyLocalChatControl::SetAudioInput() muss PartyLocalChatControl::SetAudioOutput() der audioDeviceSelectionContext Parameter auf eine Plattformbenutzer-ID festgelegt werden. Die Partei versucht dann, das Plattformstandardkommunikationsgerät zu verwenden, das diesem Benutzer zugeordnet ist. Auf Xbox One sollte die audioDeviceSelectionContext Xbox-Benutzer-ID sein, die dem Benutzer zugeordnet ist, der derzeit an das Chat-Steuerelement gebunden ist.

PartyAudioDeviceSelectionType::Manual

Wenn dieser Audiogeräteauswahltyp ausgewählt wird, PartyLocalChatControl::SetAudioInput() verwendet und PartyLocalChatControl::SetAudioOutput() verwendet den audioDeviceSelectionContext Parameter als gültigen Audiogerätebezeichner und versucht, jedes Gerät zu verwenden, das mit diesem Bezeichner übereinstimmt. In der folgenden Tabelle erfahren Sie, welche Art von Bezeichner PlayFab Party unterstützt:

Plattform Zu verwendende Informationen
Windows 10 IMMDevice oder Windows.Media.Devices
Xbox Weitere Informationen finden Sie in der Xbox GDK-Dokumentation.

Notiz

Es wird dringend empfohlen, auf Xbox One- und PartyAudioDeviceSelectionType::SystemDefault Windows-Plattformen zu verwendenPartyAudioDeviceSelectionType::PlatformUserDefault.

Chatberechtigungen und Stummschaltung

Party gibt Ihnen eine differenzierte Kontrolle darüber, wie Ihre Spieler miteinander kommunizieren können. Anstatt Teams oder Kanäle anzugeben, muss die Partei die Berechtigungen zwischen den einzelnen Chatsteuerelementen explizit definieren. Weitere Informationen zu Chatberechtigungen, Zum Stummschalten und zum Erstellen eines allgemeinen Chatszenarios finden Sie auf der Übersichtsseite für Chatberechtigungen .

Textchat, Übersetzung und Moderation

Party ermöglicht es Ihnen auch, Textchats von anderen Chat-Steuerelementen zu senden und zu empfangen. PartyLocalChatControl::SendText() Die -Methode ermöglicht es Ihnen zwar, Textnachrichten an eine beliebige Anzahl von Chatsteuerelementen zu senden, aber Sie können sicher sein, dass nur die Chatsteuerelemente mit der entsprechenden PartyChatPermissionOptions::ReceiveText Chatberechtigung die Nachrichten empfangen.

Die Textchatübersetzung kann auch durch Aufrufen PartyLocalChatControl::SetTextChatOptions()von aktiviert werden. Durch Festlegen der PartyTextChatOptions::TranslateToLocalLanguage Option Partei übersetzt eingehende SMS in die Sprache des lokalen Chatsteuerelements. Die Sprache des Chatsteuerelements kann optional während der Erstellung des Chatsteuerelements konfiguriert werden und kann durch Aufrufen PartyLocalChatControl::GetLanguage()von aufgerufen werden. Die Übersetzung wird auch auf die eingehende Spracherkennungstranskription angewendet.

Die Textmoderation ist auch für Textchats verfügbar. Weitere Informationen zu diesem Feature finden Sie auf der Seite Verwenden der Textmoderation .

Barrierefreier Chat

Unterstützt von Azure Speech Services kann Party den Sprachchat des Spielers transkribieren und Sprache aus Text synthetisieren. Diese Funktionalität hat mehrere Verwendungsmöglichkeiten, wurde aber in erster Linie als Barrierefreiheits-Aide entwickelt. Es wird empfohlen, die Aktivierung dieser Funktion an eine Erleichterte Spielereinstellung zu binden. Weitere Informationen zur Verwendung der von Party bereitgestellten Barrierefreiheitsfeatures finden Sie unter Text-zu-Sprache-Richtlinien und Spracherkennungsrichtlinien.

Unterdrückung des Audioeingangsrauschens

Party ermöglicht es Ihnen, Hintergrundgeräusche in aufgezeichneten Mikrofonaudios zu unterdrücken, bevor sie an Remote-Chat-Steuerelemente übertragen werden. Dies kann die Qualität des Sprachaudios Ihrer Spieler erheblich erhöhen. Weitere Informationen zum Aktivieren der Rauschunterdrückung finden Sie auf der Seite Verwenden der Rauschunterdrückung .

Notiz

Die Rauschunterdrückung ist derzeit nur für die Verwendung unter iOS und Android verfügbar.

Nächste Schritte