TextChannel
*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
The TextChannel sadece doğrudan mesaj gönderebilen kullanıcılara mesajlar gönderecektir DirectChatRequester.
Yöntemler
Kullanıcıya bir sistem mesajı görüntüler.
DirectChatRequester ı TextChannel için ayarlar. TextChannel yalnızca doğrudan mesaj gönderebilen kullanıcılara mesajlar gönderecektir DirectChatRequester .
Bir TextSource 'e TextChannel verilen kullanıcı kimliğine bir Player ekler.
sunucubir TextChatMessage gönderir.
Etkinlikler
Müşteride TextChannel:DisplaySystemMessage() çağrıldığında veya müşteri, sunucudan geçerli bir TextChannel:SendAsync() yanıtı aldığında ateş eder.
Geri Aramalar
Gelen bir mesaj alırken TextChannel çağrıldığında.
Her bir müşteriye çağrıldığında, TextChannel gelen bir mesaj alındığında, bu müşteriye gönderilip gönderilmeyeceği belirlenir.
Özellikler
DirectChatRequester
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
Sistem mesajı TextChannel 'ye gönderildi.
Varsayılan sistem mesajları gibi sistem mesajı türlerini tanımlamak için kullanın.
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
Dönüşler
AddUserAsync
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
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
SendAsync
sunucubir TextChatMessage gönderir. Yalnızca bir LocalScript veya Script ile kullanılabilir veya RunContext ile Enum.RunContext.Client .
Parametreler
TextChannel 'ye göndereceğiniz mesaj.
Mesaja bağlanacak özel metadatlar.
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
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
Gelen TextChatMessage .
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.
mesajalacak kullanıcının TextSource 'si.