TextService

Menghitung dimensi Vector2 yang akan diambil dengan teks saat menggunakan parameter format dan batas ukuran yang ditentukan.

Catatan, parameter ukuran huruf tidak akan menerima Enum.FontSize Enum.Sebagai gantinya, ukuran bilangan berpasangan dengan Enum.FontSize Enum harus digunakan.Ini tidak sama dengan nilai dari Enum.FontSize Enum.Sebagai contoh, untuk Size11 font, bilangan bulat 11 harus digunakan.

Fungsi ini adalah alternatif yang berguna untuk properti TextLabel.TextBounds dan TextLabel dan TextButton objek.Menggunakan properti TextLabel.TextBounds untuk menghitung teks dimensi yang diperlukan seringkali tidak praktis karena memerlukan objek TextLabel yang harus dibuat.

Dengan GetTextSize, dimensi yang diperlukan oleh string teks tertentu di khusus TextLabel atau TextButton dapat dihitung sebelum objek atau aturproperti teks dibuat.

Pengembang disarankan untuk menambahkan piksel pengisi ke hasil untuk memastikan tidak ada teks yang mati.

Metode ini terbatas hanya pada font yang terdaftar di Enum.Font. Untuk mendapatkan akses ke lebih banyak font, Anda dapat menggunakan TextService:GetTextBoundsAsync() sebagai gantinya.

Parameter

Memberikan nilai

local TextService = game:GetService("TextService")

local function getTextBounds()
	local message = "Hello World"
	local size = Vector2.new(1, 1)
	local bounds = TextService:GetTextSize(message, 12, "SourceSans", size)
	return bounds + Vector2.new(1, 1)
end

print(getTextBounds())

Terjemahan obrolan tidak didukung dalam obrolan lama.Metode ini tidak lagi didukung dan tidak boleh digunakan.Semua panggilan kembali objek kosong.Menerjemahkan pesan obrolan hanya tersedia melalui TextChatService .

Parameter

Memberikan nilai

Fungsi FilterStringAsync memfilter string yang diterima dari pengguna, menggunakan TextService , dan men返ikan TextFilterResult yang dapat digunakan untuk mendistribusikan teks yang disaring dengan benar sesuai kebutuhan

Penggunaan

Metode ini harus dipanggil setiap kali pengguna mengirim pesan.Jangan menyimpan hasil fungsi ini dan gunakan kembali untuk pesan terpisah.Jika pengguna mengirim teks yang sama berkali-kali, metode ini harus dipanggil lagi setiap kali pesan dikirim.Jika hasilnya disimpan dan digunakan kembali deteksi spam dan banyak bentuk filterisasi yang sadar konteks akan rusak dan berisiko membahayakan keselamatan pengguna.Permainan yang tidak tepat menggunakan hasil ter缓存 dapat menghadapi moderasi.

Namun, disarankan untuk menyimpan objek hasil ini untuk menampilkan pesan yang sama kepada pengguna yang bergabung dengan server nanti.Sebagai contoh: ini dapat digunakan untuk dengan aman dan efisien menerapkan log obrolan server yang selalu menggunakan filter terbatas paling sedikit untuk pengguna yang bergabung kemudian, atau untuk menampilkan teks seperti nama hewan peliharaan dengan efisien kepada pengguna yang bergabung dengan permainan setelah hewan peliharaan pertama kali dihasilkan dan disaring nama.

Parameter opsional Enum.TextFilterContext tidak akan mempengaruhi hasil filteran yang disaring dari pencarian. Nilai ini akan digunakan untuk meningkatkan filteran teks Roblox.

Teks pribadi adalah apa pun yang hanya dilihat oleh pemain tertentu, bukan oleh setiap pemain.Sebagai contoh, jika obrolan dilihat oleh satu pemain, atau oleh kelompok pemain yang dipilih, maka obrolan dianggap privat.Obrolan untuk tim atau obrolan yang berpotensi terlihat oleh grupyang lebih luas, seperti server, dianggap publik.Jika Anda tidak yakin apa teks Anda memenuhi syarat, tinggalkan bidang opsional kosong.

Catatan:

• Metode ini selalu menghasilkan untuk membuat panggilan layanan filter teks
• Metode ini dapat melempar jika terjadi kesalahan layanan yang tidak dapat diselesaikan.Jika fungsi ini menyebabkan kesalahan, jangan coba kembali permintaan; metode ini menerapkan logika putar ulang sendiri secara internal.Jika metode ini gagal tidak menampilkan teks kepada pengguna mana pun.
• Metode ini saat ini melempar jika dari userId tidak online di server saat ini.Kami berencana untuk mendukung pengguna yang offline atau di server berbeda di masa depan.

Parameter

Memberikan nilai

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local TextService = game:GetService("TextService")
local Players = game:GetService("Players")

local Remotes = Instance.new("Folder")
Remotes.Name = "PetNamingRemotes"
Remotes.Parent = ReplicatedStorage

local UserNamedPet = Instance.new("RemoteEvent")
UserNamedPet.Name = "UserNamedPet"
UserNamedPet.Parent = Remotes

local SendPetName = Instance.new("RemoteEvent")
SendPetName.Name = "SendPetName"
SendPetName.Parent = Remotes

local RequestAllPetNames = Instance.new("RemoteFunction")
RequestAllPetNames.Name = "RequestAllPetNames"
RequestAllPetNames.Parent = Remotes

local filterResults = {}

local function broadcastPetName(userId)
	local filterResult = filterResults[userId]
	if filterResult then
		for _, player in pairs(Players:GetPlayers()) do
			if player then
				-- spawn a new thread so as to not yield the update
				task.spawn(function()
					-- grab the filtered string for this user
					local toUserId = player.UserId
					local filteredString = filterResult:GetNonChatStringForUserAsync(toUserId)
					filteredString = filteredString or ""
					SendPetName:FireClient(player, userId, filteredString)
				end)
			end
		end
	end
end

UserNamedPet.OnServerEvent:Connect(function(player, petName)
	local fromUserId = player.UserId

	-- pcall to catch errors
	local success, result = pcall(function()
		return TextService:FilterStringAsync(petName, fromUserId)
	end)

	if success then
		filterResults[fromUserId] = result
		broadcastPetName(fromUserId)
	else
		print("Could not filter pet name")
	end
end)

RequestAllPetNames.OnServerInvoke = function(player)
	local toUserId = player.UserId

	local petNames = {}

	-- go through filter results and filter the pet name to be sent
	for fromUserId, filterResult in pairs(filterResults) do
		local filteredString = filterResult:GetNonChatStringForUserAsync(toUserId)
		filteredString = filteredString or ""

		-- need to convert userId to string so it can't be sent via a remote function
		petNames[tostring(fromUserId)] = filteredString
	end

	return petNames
end

Players.PlayerRemoving:Connect(function(oldPlayer)
	local userId = oldPlayer.UserId
	filterResults[userId] = nil
end)

Kembalikan tabel yang berisi nama dan wajah keluarga font.

Tabel yang dikembalikan dibangun seperti ini:

type FaceInfo = {
  Name: string, -- Contoh: "Reguler", "Buku", "Italik", "Thin Italic"
  Weight: Enum.FontWeight,
  Style: Enum.FontStyle, -- Entah Normal atau Italic
}

type FamilyInfo = {
  Name: string, -- Contoh: "Source Sans Pro", "Grenze Gotisch"
  Faces: {FaceInfo} -- Selalu ada setidaknya 1 tetapi bisa ada hingga 18.
}

Jika keluarga font sudah dimuat oleh panggilan sebelumnya ke GetFamilyInfoAsync , ContentProvider:PreloadAsync() , atau objek teks dengan aturproperti TextLabel.FontFace , maka metode tersebut kembali tanpa menyerah.

Kesalahan

Metode ini bisa gagal karena kesalahan jaringan. Anda harus selalu mengemasnya dalam pcall untuk penanganan kesalahan.

Membuang kesalahan dalam skenario ini:

• Keluarga yang dilewati adalah string kosong.
• Mengunduh keluarga gagal.
• ID aset tidak valid atau menunjuk ke aset yang tidak ada.

Parameter

Memberikan nilai

local TextService = game:GetService("TextService")

local familyToCheck = "rbxasset://fonts/families/Arial.json"

-- This is a yield function which may take up to a few seconds to download the font.
local info = TextService:GetFamilyInfoAsync(familyToCheck)

print("Name of the font:", info.Name)
print("Faces:")
for _, face in info.Faces do
	print("--------")
	print("Name:", face.Name)
	print("Weight:", face.Weight.Name)
	print("Style:", face.Style.Name)
end

Metode ini mirip dengan TextService:GetTextSize() , tetapi menggunakan objek Font alih-alih Enum.Font , yang memiliki akses ke lebih banyak font.

Digunakan untuk mengukur seberapa besar beberapa teks akan diberikan satu set properti seperti string, ukuran, dan font.

Ini adalah fungsi hasil karena beberapa font mungkin perlu dimuat untuk diukur.Jika font sudah dimuat, maka tidak akan menghasilkan.ContentProvider:PreloadAsync() dapat digunakan untuk memastikan font dimuat.

Kesalahan

Metode ini bisa gagal karena kesalahan jaringan. Anda harus selalu mengemasnya dalam pcall untuk penanganan kesalahan.

Membuang kesalahan dalam skenario ini:

• The GetTextBoundsParams.Font memiliki keluarga kosong.
• Argumen params adalah nil.
• Keluarga font atau wajah font gagal download.

Parameter

Memberikan nilai

local TextService = game:GetService("TextService")

local params = Instance.new("GetTextBoundsParams")
params.Text = "hello world!"
params.Font = Font.new("rbxasset://fonts/families/GrenzeGotisch.json", Enum.FontWeight.Thin)
params.Size = 20
params.Width = 200
local size = TextService:GetTextBoundsAsync(params)

print("The size of the text is:", size)

Parameter

Memberikan nilai