Roblox mengekspos satu ID pengguna efektif untuk setiap pengguna di setiap game, grup, atau aplikasi. Tergantung pada riwayat pengguna dengan domain tersebut, ID pengguna efektif mereka adalah ID pengguna global mereka atau ID pengguna terarah. Halaman ini menjelaskan bagaimana ID pengguna efektif bekerja dan bagaimana menggunakan tipe User dalam kode game Anda.
Konsep-konsep berikut adalah inti dari identifikasi pengguna:
| Konsep | Deskripsi |
|---|---|
| Pengguna | Akun yang persisten di Roblox. |
| Pemain | Representasi pengguna dalam model data game yang sedang berjalan (lihat Pemain). |
| tipe data User | Jenis data yang membawa ID pengguna efektif dan konteks domainnya. Ini adalah pengidentifikasi standar untuk merujuk pengguna dalam kode game. |
| ID pengguna global | ID pengguna tingkat platform yang diberikan Roblox untuk setiap akun. Ini unik secara global di seluruh Roblox. |
| ID pengguna terarah | ID pengguna yang diberikan dalam domain tertentu. ID pengguna terarah seorang pengguna berbeda di setiap game, grup, atau aplikasi. |
| ID pengguna efektif | ID pengguna tunggal yang diekspos Roblox untuk pengguna dalam sebuah domain. |
| Pengguna pra-luncuran | Pengguna yang pertama kali terlibat dengan domain sebelum peluncuran ID pengguna terarah. Dalam domain tersebut, ID pengguna efektif mereka tetap menjadi ID pengguna global mereka. |
| Pengguna pasca-luncuran | Pengguna yang pertama kali terlibat dengan domain setelah peluncuran ID pengguna terarah. Dalam domain tersebut, ID pengguna efektif mereka adalah ID pengguna terarah. |
ID pengguna efektif dan domain
Setiap pengguna memiliki satu ID pengguna efektif dalam game, grup, atau aplikasi tertentu. Roblox tidak mengekspos ID pengguna global dan terarah yang terpisah untuk pengguna yang sama dalam domain tersebut:
- Seorang pengguna pra-luncuran memiliki ID pengguna global mereka sebagai ID pengguna efektif mereka.
- Seorang pengguna pasca-luncuran memiliki ID pengguna terarah sebagai ID pengguna efektif mereka. ID tersebut hanya berarti dalam domain tersebut.
Dalam kode game, Player.UserId dan Player.User.Id keduanya mengembalikan ID pengguna efektif ini dan selalu memiliki nilai numerik yang sama (Player.User.Id sama dengan Player.UserId), sehingga kode Anda tidak perlu logika percabangan untuk memilih di antara keduanya.
Roblox membatasi identitas pengguna di tiga jenis domain:
| Domain | Terarah ke | Contoh |
|---|---|---|
| Pengalaman (Enum.DomainType.EXPERIENCE) | Sebuah pengalaman tertentu | ID pemain di pengalaman Anda |
| Grup | Sebuah grup Roblox tertentu (komunitas) | ID anggota di grup Anda |
| Aplikasi OAuth (Enum.DomainType.OAUTH) | Sebuah aplikasi OAuth tertentu | ID pengguna di alat eksternal Anda |
Cara kerja ID pengguna efektif
Ketika seorang pemain bergabung dengan game Anda, mereka memiliki satu ID pengguna efektif untuk game tersebut. ID pengguna efektif seorang pengguna pasca-luncuran adalah ID pengguna terarah yang unik untuk game tersebut. Mereka menerima ID pengguna terarah yang berbeda di game, grup, atau aplikasi lain di mana mereka juga merupakan pengguna pasca-luncuran. Ini berarti:
- ID pengguna efektif adalah bilangan bulat, baik itu global atau terarah.
- ID pengguna efektif stabil di seluruh sesi dalam domain yang sama.
- ID pengguna terarah tidak bertabrakan dengan ID pengguna global yang ada.
- Nilai numerik yang sama dapat muncul di domain yang berbeda untuk pengguna yang berbeda. Kunci unik adalah kombinasi dari domain (tipe domain dan ID domain) dan ID pengguna efektif.
Contoh skenario
Contoh berikut menunjukkan bagaimana game yang berbeda merujuk pengguna yang sama:
| Skenario | Konteks pengguna | ID pengguna efektif yang dilihat oleh game |
|---|---|---|
| Pengguna terhubung ke Game A | Pengguna pra-luncuran | 123 (ID pengguna global, tidak berubah) |
| Pengguna terhubung ke Game B | Pengguna pasca-luncuran | 500789 (ID pengguna terarah untuk Game B) |
| Pengguna terhubung ke Game C | Pengguna pasca-luncuran | 302441 (ID pengguna terarah untuk Game C) |
Pengguna pra-luncuran
Jika seorang pemain adalah pengguna pra-luncuran di game Anda, ID pengguna efektif mereka tetap menjadi ID pengguna global mereka dalam game tersebut. Baik Player.UserId dan Player.User.Id mengembalikan ID pengguna global tersebut. Roblox tidak mengekspos ID pengguna kedua untuk pemain dalam game tersebut. Ini memastikan kunci penyimpanan data yang ada, papan peringkat, dan inventaris terus berfungsi tanpa perubahan.
Domain grup
Setiap grup Roblox adalah domainnya sendiri. Seorang pengguna memiliki satu ID pengguna efektif dalam grup, terpisah dari ID pengguna efektif mereka di game atau aplikasi OAuth mana pun:
- Pemeriksaan grup dalam game tidak berubah — Metode engine pada Player seperti Player:IsInGroupAsync(), Player:GetRankInGroupAsync(), dan Player:GetRoleInGroupAsync(), serta GroupService:PromptJoinAsync(), menyelesaikan identitas secara internal tanpa mengekspos ID pengguna.
- API grup Open Cloud menggunakan domain grup — Ini berlaku untuk endpoint yang mencantumkan atau mengelola keanggotaan grup dan permintaan bergabung.
Bekerja dengan Tipe Pengguna
User adalah cara standar untuk mengidentifikasi pengguna dalam kode game. Nilai User membawa ID pengguna efektif bersama dengan tipe domain dan ID domain, sehingga konteks identitas selalu dibawa bersama pengidentifikasi. Untuk detail API lengkap, lihat referensi User.
Mendapatkan Pengguna dari Pemain
Cara utama untuk mendapatkan User adalah dari Player yang terhubung melalui Player.User:
local Players = game:GetService("Players")
Players.PlayerAdded:Connect(function(player)
local user = player.User
print("ID pengguna efektif:", user.Id) -- Selalu cocok dengan player.UserId
print("Tipe domain:", user.DomainType)
print("ID domain:", user.DomainId)
end)Membuat Pengguna dari ID
Untuk membuat User dari ID pengguna efektif yang diketahui dalam game saat ini, gunakan User.fromId():
local user = User.fromId(knownUserId)Menggunakan Pengguna dengan API engine
API engine yang menerima parameter ID pengguna juga menerima nilai User secara langsung. Menggunakan User sangat dianjurkan:
-- Kedua bentuk berfungsi:
BadgeService:AwardBadge(player.User, badgeId) -- Disarankan
BadgeService:AwardBadge(player.UserId, badgeId)-- Kedua bentuk berfungsi:
local target = Players:GetPlayerByUserId(player.User) -- Disarankan
local target = Players:GetPlayerByUserId(someUserId)Ketika ID pengguna numerik diteruskan ke API engine yang menerima ID pengguna, itu secara otomatis dibungkus menjadi User secara internal.
API engine yang mengembalikan ID pengguna
API engine yang mengembalikan ID pengguna numerik mengembalikan ID pengguna efektif pengguna:
- Pengguna pra-luncuran — API mengembalikan ID pengguna global pengguna.
- Pengguna pasca-luncuran — API mengembalikan ID pengguna terarah pengguna.
Player.UserId, Player.User.Id, dan API engine lainnya semua mengembalikan ID pengguna efektif yang sama untuk pengguna di game Anda, sehingga kode yang ada yang membaca bidang ID pengguna numerik terus berfungsi tanpa logika percabangan.
Permintaan dan respons Open Cloud menggunakan ID pengguna efektif yang sama untuk domain target. Mereka tidak mengekspos ID pengguna kedua untuk pengguna yang sama dalam domain tersebut.
Menyimpan identitas pengguna
Gunakan ID pengguna efektif numerik hanya untuk mengidentifikasi pengguna dalam satu domain. Kunci penyimpanan data dalam satu game dapat menggunakan user.Id secara langsung:
local key = ("player_%d"):format(player.User.Id)
PlayerDataStore:SetAsync(key, data)Ketika domain lain membaca identitas yang disimpan, seperti aplikasi OAuth yang memoderasi pengguna, simpan string dari ToString(). String tersebut mengkode konteks domain bersama dengan ID pengguna efektif. Menggunakan integer saja dapat menerapkan tindakan pada pengguna yang salah ketika nomor yang sama mengidentifikasi pengguna yang berbeda di domain lain.
local encoded = player.User:ToString()
SomeDataStore:SetAsync("support_ticket_user", encoded)
-- Nanti, pulihkan dari string
local user = User.fromString(encoded)Untuk detail lebih lanjut tentang jaminan serialisasi, lihat referensi User.
Praktik terbaik
- Gunakan Player.User sebagai pengidentifikasi standar dalam kode baru.
- Gunakan ID pengguna efektif numerik hanya dalam satu domain, seperti kunci penyimpanan data untuk satu game.
- Gunakan ToString() dan fromString() ketika domain lain membaca identitas yang disimpan.