TextChannel

Artık kullanılmayanları göster

*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

Bir metin sohbet kanalını temsil eder. İçinde TextSources çocuklar olarak bulunur.

Bir sohbet mesajını TextChannel 'a göndermek için, bir TextChannel:SendAsync() 'dan çağrın LocalScript .Kullanıcının TextSource ile eşleşen TextSource.CanSend = true kanalında olması gerekir.

Farklı TextChannels'dan gelen mesajlar, ChannelTabsConfiguration kullanarak sohbet penceresinde farklı sekmelere ayrılabilir.

Daha fazla bilgi için, Deneyim İçi Metin Sohbeti görün.

Özet

Özellikler

  • Salt Okunur
    Çoğaltılmamış
    Paralel oku

    The TextChannel sadece doğrudan mesaj gönderebilen kullanıcılara mesajlar gönderecektir DirectChatRequester.

Yöntemler

Geri Aramalar

Özellikler

DirectChatRequester

Salt Okunur
Çoğaltılmamış
Paralel oku

The TextChannel sadece doğrudan mesaj gönderebilen kullanıcılara mesajlar gönderecektir DirectChatRequester. Bu özellik yalnızca SetDirectChatRequester() kullanılarak ayarlanabilir.

Yöntemler

DisplaySystemMessage

Kullanıcıya bir sistem mesajı görüntüler.Sadece bir LocalScript , veya Script 'de RunContext ile kullanılabilir Enum.RunContext.Client .Mesajlar sadece o kullanıcıya görünür ve otomatik olarak filtrelenir veya yerelleştirilmez.

Parametreler

systemMessage: string

Sistem mesajı TextChannel 'ye gönderildi.

Varsayılan değer: ""
metadata: string

Varsayılan sistem mesajları gibi sistem mesajı türlerini tanımlamak için kullanın.

Varsayılan değer: ""

Dönüşler

mesajkoşulunu gösteren bir TextChatMessage özelliği ile TextChatMessage.Status özellikli bir A

SetDirectChatRequester

()

DirectChatRequester ı TextChannel için ayarlar. Bu yöntem yalnızca sunucu kodlarında kullanılabilir.

TextChatService ile çalışıyorsanız ve varsayılan metin kanallarının dışında özel bir doğrudan sohbet uygulamasına sahipseniz, bu API'yi kullanın.

TextChannel ile çağrıldığında, ebeveyn olarak TextChatService ve mevcut TextSources yoksa, SetDirectChatRequester istenen kullanıcıları kanal için TextSource olarak ekler ve DirectChatRequester özelliğini kanal için ayarlar.

DirectChatRequester ayarlandığında, yalnızca DirectChatRequester ile sohbet yönlendirebilen kullanıcılar arasındaki mesajlar gönderilir.


local function createWhisperChannel(fromPlayer, toPlayer)
local whisperChannel = Instance.new("TextChannel")
whisperChannel:SetDirectChatRequester(fromPlayer)
whisperChannel:AddUserAsync(toPlayer.UserId)
-- TextChannel instansı artık iki TextSource instansına sahiptir.
return whisperChannel
end

Parametreler

requester: Player
Varsayılan değer: ""

Dönüşler

()

AddUserAsync

Bekletir

Kullanıcının verilen kullanıcı kimliğine ekler ( ile). Sadece bir içinde kullanılabilir.

Kullanıcıyı temsil eden bir TextSource yoksa, bunun bir TextSource eklenir.

Kullanıcıyı temsil eden bir TextSource varsa, bu TextSource döndürür.

Kullanıcının sohbeti kapalı veya sunucuda olmadığında, bu bir tupl döndürür nil , false .

Parametreler

userId: number

Player 'nin kullanıcı kimliği.

Varsayılan değer: ""

Dönüşler

Kullanıcı için yeni bir TextSource ve true oluşturulduğunda, TextSource ve TextSource varsa mevcut bir false veya TextSource varsa kullanıcının sohbeti kapalı veya bu sunucuda değilse veya nil ve false kullanıcının sohbeti kapalı veya bu sunucuda değilse varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa varsa

Bekletir

sunucubir TextChatMessage gönderir. Yalnızca bir LocalScript veya Script ile kullanılabilir veya RunContext ile Enum.RunContext.Client .

Parametreler

message: string

TextChannel 'ye göndereceğiniz mesaj.

Varsayılan değer: ""
metadata: string

Mesaja bağlanacak özel metadatlar.

Varsayılan değer: ""

Dönüşler

mesajkoşulunu gösteren bir TextChatMessage özelliği ile TextChatMessage.Status özellikli bir A

Etkinlikler

MessageReceived

Like TextChatService.MessageReceived , istemciye TextChannel:DisplaySystemMessage() çağrıldığında veya istemci, sunucudan geçerli bir TextChannel:SendAsync() yanıtı aldığında ateş eder.Bu olay yalnızca istemci üzerinde ateşlenir.

sunucuTextChannel.ShouldDeliverCallback özelliği bağlanmış ve false geri döndürürse, istemci TextChannel.MessageReceived ateş etmez.

TextChatMessage ve mesajın metnini almak için TextSource ve TextChatMessage.Text parametresini kullanın.

TextChatMessage parametri, TextChatService.OnIncomingMessage veya TextChannel.OnIncomingMessage bağlı herhangi bir işlevin sonuçudur.

Parametreler

incomingMessage: TextChatMessage

Alınan TextChatMessage .


Geri Aramalar

OnIncomingMessage

TextChannel gelen bir mesaj alırken çağrılır. Sadece istemci üzerinde uygulanabilir.

Bunu TextChatMessages dekore etmek için kullanın.Bu geri arama bir TextChatMessageProperties döndürürse, bu özellikler yeni bir TextChatMessage oluşturmak için TextChatMessage ile birleştirilir.

Mesaj gönderen müşteriye bağlandığında, bu geri çağrı iki kez çalıştırılır; öncelikle mesaj ilk kez yerel olarak gönderilir ve ardından müşteri, filtrelenmiş mesajın sonucunu sunucudan alır.

TextChannel.OnIncomingMessage geri çağrıları daima sonra TextChatService.OnIncomingMessage geri çağrıdan sonra çalışır.

Bu, kaynak kodunda sadece bir kez tanımlanmalıdır: TextChannelAynı kanala yönelik çok sayıda bağlantı, belirli olmayan bir şekilde birbirlerini geçecektir.

TextChatService:CreateDefaultTextChannels() doğru olduğunda, bu varsayılan TextChannels özellikle özel davranış sergilemek için içeride atanmış TextChannel.OnIncomingMessage geri çağrıları vardır.

Parametreler


Dönüşler

Bir TextChatMessageProperties döndürülürse, bu özellikler TextChatMessage ile birleştirilir ve bu özelliklerle yeni bir TextChatMessage oluşturulur.

ShouldDeliverCallback

Her bir müşteriye çağrıldığında, TextChannel gelen bir mesaj alındığında, bu müşteriye gönderilip gönderilmeyeceği belirlenir.Sadece sunucuda tanımlanabilir.

Tanımlandıktan sonra, bu geri arama true , 1 veya "hello" gibi doğru bir değer döndürmelidir, mesajı söz konusu istemciye göndermek için.Geri çağrı başka bir şey döndürürse (nil dahil), mesaj o alıcıya gönderilmeyecek, ancak gönderen mesajı görürsüz.

Gönderici TextChatMessage.TextSource tarafından referans edilebilirken, alıcı textSource argümanıdır.Gönderici ve alıcı aynı olabilir, çünkü geri çağrı tüm olası alıcılardan geçer.Roblox Studio'da, solo Oynama modunda bir mesajın tek göndericisi ve alıcısı olacaksınız.

Parametreler

Mesajın gönderildiği mesaj, ki bu da mesajın göndericisini içerir.

textSource: TextSource

mesajalacak kullanıcının TextSource 'si.


Dönüşler