StarterGui

Hiển Thị Bản Đã Lỗi Thời

*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.

Không Thể Tạo
Dịch Vụ

StarterGui là một đối tượng thùng được thiết kế để giữ LayerCollector các đối tượng như ScreenGuis .

Khi một Player.Character sinh ra, nội dung của họ PlayerGui (nếu có) được rỗng.Con cháu của StarterGui sau đó được sao chép cùng với con cháu của họ vào PlayerGui .Tuy nhiên, hãy lưu ý rằng các đối tượng như với bộ đặt tính chất của họ sẽ chỉ được đặt vào mỗi người chơi một lần và sẽ không bị xóa khi các respawns.

StarterGui cũng bao gồm một loạt các chức năng cho phép bạn tương tác với CoreGui .Ví dụ StarterGui:SetCoreGuiEnabled() có thể được sử dụng để vô hiệu hóa các yếu tố của CoreGui , và StarterGui:SetCore() có thể thực hiện một loạt các chức năng bao gồm tạo thông báo và tin nhắn hệ thống.

Tóm Tắt

Thuộc Tính

Xem tất cả các mục kế thừa từ Instance
Xem tất cả các mục kế thừa từ Object

Phương Pháp

Phương Pháp kế thừa từ BasePlayerGui
Xem tất cả các mục kế thừa từ Instance
Xem tất cả các mục kế thừa từ Object

Thuộc Tính

ProcessUserInput

boolean
Ẩn
Không Sao Chép
Bảo Mật Plugin
Đọc Song Song

Cho phép StarterGui xử lý đầu vào giống như PlayerGui và CoreGui làm. Giá trị mặc định là false .

RtlTextSupport

Enum.RtlTextSupport
Không Thể Viết Kịch Bản
Đọc Song Song

ScreenOrientation

Enum.ScreenOrientation
Đọc Song Song

Thuộc tính này đặt chế độ xoay màn hình ưa thích cho người dùng có thiết bị di động. Đối với các chế độ khác có sẵn, xem Enum.ScreenOrientation .

Mặc định, thuộc tính này được đặt thành Sensor , có nghĩa là trải nghiệm được hiển thị tùy thuộc vào trận phù hợp tốt nhất với hướng hiện tại của thiết bị, hoặc là cảnh quan (bên trái/phải) hoặc dọc.

Khi một tham gia vào trải nghiệm trên thiết bị di động, thuộc tính này xác định hướng bắt đầu của thiết bị và đặt hướng của người chơi đó theo đó.Bạn cũng có thể nhận được hướng hiện tại của màn hình người chơi thông qua PlayerGui.CurrentScreenOrientation , hữu ích khi sử dụng một trong những cài đặt "cảm biến" Enum.ScreenOrientation .

Lưu ý rằng việc thay đổi thuộc tính này sẽ không thay đổi hướng màn hình cho Players đã có trong trải nghiệm.Để thay đổi hướng cho một người chơi hiện có, hãy sử dụng thuộc tính PlayerGui.ScreenOrientation của họ.

ShowDevelopmentGui

boolean
Đọc Song Song

Tính chất này xác định xem nội dung của StarterGui có hiển thị trong Studio hay không.

VirtualCursorMode

Enum.VirtualCursorMode
Không Thể Viết Kịch Bản
Đọc Song Song
Xem tất cả các mục kế thừa từ Instance
Xem tất cả các mục kế thừa từ Object

Phương Pháp

GetCoreGuiEnabled

boolean

Chức năng này trả về xem liệu Enum.CoreGuiType được bật hay không, hoặc nếu nó đã bị vô hiệu hóa bằng cách sử dụng StarterGui:SetCoreGuiEnabled() .Chức năng này nên được gọi trên máy khách.

Lưu ý rằng việc đặt "TopbarEnabled" đến false bằng SetCore() che phủ tất cả CoreGuiTypes nhưng không ảnh hưởng đến kết quả của chức năng này.

Tham Số

coreGuiType: Enum.CoreGuiType

Các được cung cấp Enum.CoreGuiType .

Giá Trị Mặc Định: ""

Lợi Nhuận

boolean

Whether the given Enum.CoreGuiType được bật.

Mẫu mã

The below example would print whether or not the player list is visible to the LocalPlayer.

Checking if a Core GUI is Enabled
local StarterGui = game:GetService("StarterGui")



print(StarterGui:GetCoreGuiEnabled("PlayerList"))

SetCore

()

Phương pháp này (không nên nhầm lẫn với SetCoreGuiEnabled() ) tiết lộ một loạt các chức năng được định nghĩa bởi các kịch bản lõi của Roblox, chẳng hạn như gửi thông báo, chuyển đổi thông báo cho danh hiệu/điểm, xác định một cuộc gọi lại cho nút reset hoặc chuyển đổi thanh trên cùng

Tham số đầu tiên là một chuỗi chọn chức năng mà cuộc gọi sẽ tương tác.Có thể cần phải gọi phương pháp này nhiều lần bằng cách sử dụng pcall() trong trường hợp kịch bản lõi tương ứng chưa được tải (hoặc nếu nó đã bị vô hiệu hóa hoàn toàn).

Bảng sau đây mô tả các chuỗi có thể được chấp nhận là tham số đầu tiên.Các tham số nên theo dõi phụ thuộc vào chức năng sẽ được sử dụng và được mô tả trong các bảng phụ.

Trò chuyệnActive

Kiểm soát xem trò chuyện có đang hoạt động hay không.

<th>Loại</th>



    <th>Mặc định</th>



    <th>Mô tả</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>hoạt động</code></td>



    <td>boolean như vậy</td>



    <td>(bắt buộc)</td>



    <td>Xác định xem trò chuyện có nên được bật lên hay không.</td>

  </tr>

</tbody>
Tên
Thông báo điểm hoạt động

Kiểm soát xem có hiển thị thông báo về điểm người chơi kiếm được hay không.

<th>Loại</th>



    <th>Mặc định</th>



    <th>Mô tả</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>hoạt động</code></td>



    <td>boolean như vậy</td>



    <td>(bắt buộc)</td>



    <td>Xác định xem có xuất hiện thông báo cho điểm người chơi kiếm được hay không.</td>

  </tr>

</tbody>
Tên
Thông báo cảnh báo BadgesActive

Kiểm soát xem có hiển thị thông báo cho các huy hiệu đã kiếm được hay không.

<th>Loại</th>



    <th>Mặc định</th>



    <th>Mô tả</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>hoạt động</code></td>



    <td>boolean như vậy</td>



    <td>(bắt buộc)</td>



    <td>Xác định xem có xuất hiện thông báo cho các huy hiệu kiếm được hay không.</td>

  </tr>

</tbody>
Tên
Nút khôi phục lại cuộc gọi

Xác định hành vi, nếu có, của nút reset được cung cấp một boolean hoặc BindableEvent để bắn khi một người chơi yêu cầu đặt lại.

<th>Loại</th>



    <th>Mặc định</th>



    <th>Mô tả</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>đã bật</code></td>



    <td>boolean như vậy</td>



    <td>(bắt buộc)</td>



    <td>Xác định xem nút reset có giữ lại hành vi mặc định của nó hay không.</td>

  </tr>



  <tr>

    <td colspan="4"><b>OR</b></td>

  </tr>



  <tr>

    <td><code>trả lại callback</code></td>



    <td><code>Sự kiện Class.BindableEvent</code></td>



    <td>(bắt buộc)</td>



    <td>Một <code>Class.BindableEvent</code> sẽ bị kích hoạt khi người chơi xác nhận họ muốn trả về mặc định.</td>

  </tr>

</tbody>
Tên
Tạo tin nhắn hệ thống trò chuyện

Hiển thị một tin nhắn định dạng trong trò chuyện.Sử dụng phương pháp này yêu cầu kinh nghiệm được đặt thành , mặc dù chat cũ đã bị loại bỏ và sử dụng bị ngăn cấm.Đối với trải nghiệm sử dụng hiện tại TextChatService , tham khảo TextChannel:DisplaySystemMessage() .

<th>Loại</th>



    <th>Mặc định</th>



    <th>Mô tả</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>bảng configTable</code></td>



    <td>từ điển</td>



    <td>(bắt buộc)</td>



    <td>Một từ điển thông tin mô tả tin nhắn (xem dưới).</td>

  </tr>

</tbody>
Tên
<th>Loại</th>



    <th>Mặc định</th>



    <th>Mô tả</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>Văn bản</code></td>



    <td>chuỗi</td>



    <td>(bắt buộc)</td>



    <td>Tin nhắn để hiển thị.</td>

  </tr>



  <tr>

    <td><code>Màu</code></td>



    <td><code>Loại dữ liệu.Màu3</code></td>



    <td><code>Loại dữ liệu.Color3.fromRGB(255, 255, 243)</code></td>



    <td>Màu văn bản của tin nhắn.</td>

  </tr>



  <tr>

    <td><code>Phông chữ</code></td>



    <td><code>Enum.Font</code></td>



    <td><code>NguồnSansBold</code></td>



    <td>Phông chữ của tin nhắn.</td>

  </tr>



  <tr>

    <td><code>Kích thước văn bản</code></td>



    <td>số nguyên</td>



    <td><code>18</code></td>



    <td>Kích thước văn bản của tin nhắn.</td>

  </tr>

</tbody>
Tên
Gửi thông báo

Gây ra thông báo không làm phiền xuất hiện ở phía dưới bên phải của màn hình. Thông báo có thể có tối đa hai nút.

<th>Loại</th>



    <th>Mặc định</th>



    <th>Mô tả</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>bảng configTable</code></td>



    <td>từ điển</td>



    <td>(bắt buộc)</td>



    <td>Một từ điển thông tin mô tả thông báo (xem dưới).</td>

  </tr>

</tbody>
Tên
<th>Loại</th>



    <th>Mặc định</th>



    <th>Mô tả</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>Tiêu đề</code></td>



    <td>chuỗi</td>



    <td>(bắt buộc)</td>



    <td>Tiêu đề của thông báo.</td>

  </tr>



  <tr>

    <td><code>Văn bản</code></td>



    <td>chuỗi</td>



    <td>(bắt buộc)</td>



    <td>Văn bản chính của thông báo.</td>

  </tr>



  <tr>

    <td><code>Biểu tượng</code></td><td>chuỗi</td>



    <td />



    <td>Hình ảnh để hiển thị với thông báo.</td>

  </tr>



  <tr>

    <td><code>Thời lượng</code></td>



    <td>số</td>



    <td><code>5</code></td>



    <td>Thời lượng (theo giây) thông báo nên vẫn hiển thị.</td>

  </tr>



  <tr>

    <td><code>Gọi lại</code></td><td><code>Class.BindableFunction</code></td>



    <td />



    <td>Một <code>Class.BindableFunction</code> nên được gọi với văn bản của nút được nhấn bởi người chơi.</td>

  </tr>



  <tr>

    <td><code>Nút1</code></td><td>chuỗi</td>



    <td />



    <td>Văn bản để hiển thị trên nút đầu tiên.</td>

  </tr>



  <tr>

    <td><code>Nút2</code></td><td>chuỗi</td>



    <td />



    <td>Văn bản để hiển thị trên nút thứ hai.</td>

  </tr>

</tbody>
Tên
TopbarEnabled được bật

Xác định xem thanh trên cùng có được hiển thị hay không.Vô hiệu hóa thanh trên cùng cũng sẽ vô hiệu hóa tất cả CoreGuis như trò chuyện, kho hàng, và danh sách người chơi ( ví dụ, những người được thiết lập với SetCoreGuiEnabled ).

Khi bị vô hiệu hóa, khu vực thanh trên cùng một lần đã chiếm sẽ vẫn tiếp nhận sự kiện chuột; tuy nhiên, các nút được đặt ở đó sẽ không đáp ứng lại sự kiện nhấp chuột.Nguồn gốc của không gian GUI vẫn sẽ bị trừ 36 pixel từ phía trên của màn hình.

<th>Loại</th>



    <th>Mặc định</th>



    <th>Mô tả</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>đã bật</code></td>



    <td>boolean như vậy</td>



    <td>(bắt buộc)</td>



    <td>Xác định xem thanh trên cùng có nên hiển thị hay không.</td>

  </tr>

</tbody>
Tên
DevConsoleVisible được hiển thị

Xác định xem Bảng điều khiển Nhà phát triển có hiển thị hay không.

<th>Loại</th>



    <th>Mặc định</th>



    <th>Mô tả</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>tầm nhìn</code></td>



    <td>boolean như vậy</td>



    <td>(bắt buộc)</td>



    <td>Xác định xem console có hiển thị hay không.</td>

  </tr>

</tbody>
Tên
Yêu cầu gửi bạn bè nhanh chóng

Yêu cầu người chơi hiện tại gửi yêu cầu kết bạn đến Player đã cho.

<th>Loại</th>



    <th>Mặc định</th>



    <th>Mô tả</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>người chơi</code></td>



    <td><code>Lớp.Player</code></td>



    <td>(bắt buộc)</td>



    <td>Người chơi mà yêu cầu bạn bè nên được khoản</td>

  </tr>

</tbody>
Tên
Bạn bè thông báo

Yêu cầu người chơi hiện tại xóa một địa chỉ Player đã cho từ danh sách bạn bè của họ.

<th>Loại</th>



    <th>Mặc định</th>



    <th>Mô tả</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>người chơi</code></td>



    <td><code>Lớp.Player</code></td>



    <td>(bắt buộc)</td>



    <td>Người chơi nên bị xóa bạn.</td>

  </tr>

</tbody>
Tên
Khối lưu trữ thông báo

Yêu cầu người chơi hiện tại chặn Player đã cho.

<th>Loại</th>



    <th>Mặc định</th>



    <th>Mô tả</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>người chơi</code></td>



    <td><code>Lớp.Player</code></td>



    <td>(bắt buộc)</td>



    <td>Người chơi nên bị chặn.</td>

  </tr>

</tbody>
Tên
Người chặn xóa nhanh chóng người chơi

Yêu cầu người chơi hiện tại mở khóa Player đã cho.

<th>Loại</th>



    <th>Mặc định</th>



    <th>Mô tả</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>người chơi</code></td>



    <td><code>Lớp.Player</code></td>



    <td>(bắt buộc)</td>



    <td>Người chơi nên được mở khóa.</td>

  </tr>

</tbody>
Tên
Menu Avatar Context được bật

Xác định xem liệu Menu ngữ cảnh Avatar có được bật không.

<th>Loại</th>



    <th>Mặc định</th>



    <th>Mô tả</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>đã bật</code></td>



    <td>boolean như vậy</td>



    <td>(bắt buộc)</td>



    <td>Xác định xem menu bối cảnh được bật hay không.</td>

  </tr>

</tbody>
Tên
Menu mục tiêu AvatarContext

Bắt buộc mở Menu ngữ cảnh Avatar.

<th>Loại</th>



    <th>Mặc định</th>



    <th>Mô tả</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>người chơi</code></td>



    <td><code>Lớp.Player</code></td>



    <td>(bắt buộc)</td>



    <td>Người chơi mà menu ngữ cảnh sẽ được mở.</td>

  </tr>

</tbody>
Tên
Thêm tùy chọn thực đơn AddAvatarContext

Thêm một lựa chọn vào Tùy chọn menu ngữ cảnh Avatar.

<th>Loại</th>



    <th>Mặc định</th>



    <th>Mô tả</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>tùy chọn</code></td>



    <td><code>Tùy chọn Menu bối cảnh Avatar Enum.AvatarContextMenuOption</code></td>



    <td>(bắt buộc)</td>



    <td>Tùy chọn để thêm.</td>

  </tr>



  <tr>

    <td colspan="4"><b>OR</b></td>

  </tr>



  <tr>

    <td><code>tùy chọn</code></td>



    <td>bảng</td>



    <td>(bắt buộc)</td>



    <td>Một bảng hai thành phần, nơi thành phần đầu tiên là tên của hành động tùy chỉnh, và thành phần thứ hai là một <code>Class.BindableEvent</code> sẽ bị bắn khi tùy chọn được kích hoạt.</td>

  </tr>

</tbody>
Tên
Loại bỏAvatarContextMenuOption

Loại bỏ một lựa chọn cho T menu ngữ cảnh Avatar. Tham số option phải giống như những gì đã được sử dụng với "AddAvatarContextMenuOption" (xem trên).

<th>Loại</th>



    <th>Mặc định</th>



    <th>Mô tả</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>tùy chọn</code></td>



    <td>Biến thể</td>



    <td>(bắt buộc)</td>



    <td>Giá trị tương tự được cung cấp cho <b>AddAvatarContextMenuOption</b>.</td>

  </tr>

</tbody>
Tên
Chủ đề menu ngữ cảnh Avatar

Cài đặt menu bối cảnh Avatar có thể tùy chỉnh Avatar Context Menu, đây là một tính năng tùy chọn cho phép dễ dàng tương tác xã hội giữa người chơi thông qua các hành động tùy chỉnh, chẳng hạn như khởi động giao dịch, trận chiến và nhiều hơn nữa.Để biết thêm thông tin về cách tùy chỉnh chủ đề của nó, hãy xem bài viết Avatar Context Menu.

Kết nối CoreGuiChat

Thiết lập kết nối gateway có thể gắn kết giữa nút trò chuyện của thanh trên cùng CoreGui và hệ thống trò chuyện cũ.Tham số thứ hai phải là một bảng của BindableEvents và BindableFunctions .

Tham Số

parameterName: string

Chọn chức năng mà cuộc gọi sẽ tương tác.

Giá Trị Mặc Định: ""
value: Variant

Một bảng của BindableEvents và BindableFunctions.

Giá Trị Mặc Định: ""

Lợi Nhuận

()

Mẫu mã

StarterGui Setting Core GUI
local StarterGui = game:GetService("StarterGui")



StarterGui:SetCore("AvatarContextMenuTheme", {

	BackgroundImage = "",

	BackgroundTransparency = 0.5,

	BackgroundColor = Color3.fromRGB(111, 145, 242),

	NameTagColor = Color3.fromRGB(0, 0, 200),

	NameUnderlineColor = Color3.fromRGB(213, 233, 255),

	ButtonFrameColor = Color3.fromRGB(15, 24, 65),

	ButtonFrameTransparency = 0.2,

	ButtonUnderlineColor = Color3.fromRGB(213, 233, 255),

	Font = Enum.Font.SciFi,

})

SetCoreGuiEnabled

()

Chức năng này xác định xem liệu thành phần CoreGui liên quan đến Enum.CoreGuiType được cho phép hay bị vô hiệu hóa.

Thanh trên cùng không thể bị vô hiệu hóa bằng cách sử dụng chức năng này. Để vô hiệu hóa nó, hãy đặt "TopbarEnabled" đến false bằng cách sử dụng StarterGui:SetCore() .

Tham Số

coreGuiType: Enum.CoreGuiType

Các được cung cấp Enum.CoreGuiType .

Giá Trị Mặc Định: ""
enabled: boolean

Có nên bật hoặc tắt bỏ Enum.CoreGuiType đã cho.

Giá Trị Mặc Định: ""

Lợi Nhuận

()

GetCore

Variant
Sinh Lợi

Phương pháp này trả về bộ dữ liệu hoặc được cung cấp bởi các kịch bản lõi của Roblox.Tham số đầu tiên và duy nhất là một chuỗi chọn thông tin để lấy.Các phần sau đây mô tả các chuỗi và dữ liệu họ trả bởi chức năng này.

Gọi phương pháp này có thể cho ra. Nhiều trong số chúng cũng đăng ký một chức năng tương đương SetCore() (chúng được đánh dấu bằng một dấu sao).

Thông báo điểm hoạt động *

Trả về true nếu thông báo điểm của người chơi được bật.

Thông báo BadgesNotificationsActive *

Trả về true nếu thông báo huy hiệu được bật.

Menu Bối cảnh Avatar đã bật *

Trả về true nếu Thực đơn ngữ cảnh Avatar được bật.

Trò chuyệnActive *

Trả về xem cuộc trò chuyện có đang hoạt động hay không. Điều này được chỉ ra bởi tình trạng lựa chọn của biểu tượng trò chuyện của thanh trên cùng.

Kích thước ChatWindow *

Trả về kích thước của cửa sổ trò chuyện như một UDim2 .

Vị trí ChatWindowPosition *

Trả về kích thước của cửa sổ trò chuyện như một UDim2 .

Vô hiệu hóa ChatBar *

Trả về true nếu thanh trò chuyện bị vô hiệu hóa.

Nhận ID người dùng bị chặn

Trả về một danh sách của UserIds liên quan đến người dùng đã bị chặn bởi người chơi địa phương.

Sự kiện PlayerBlockedEvent

Trả về một BindableEvent được bắn ra bất cứ khi nào một người chơi bị chặn bởi người chơi địa phương.

Sự kiện PlayerUnblocked

Trả về một BindableEvent được bắn ra bất cứ khi nào một người chơi bị mở khóa bởi người chơi địa phương.

Sự kiện PlayerMuted

Trả về một BindableEvent được bắn khi nào một người chơi bị tắt tiếng bởi người chơi địa phương.

Sự kiện PlayerUnmuted

Trả về một BindableEvent được bắn ra bất cứ khi nào một người chơi bị tắt tiếng bởi người chơi địa phương.

Sự kiện PlayerFriended

Trả về một BindableEvent được bắn ra bất cứ khi nào một người chơi được kết bạn bởi người chơi địa phương.

Sự kiện PlayerUnfriended

Trả về một BindableEvent được bắn khi nào một người chơi bị người chơi địa phương xóa bạn bè.

DevConsoleVisible*

Trả về true nếu Bảng điều khiển Nhà phát triển hiển thị.

VRRotationIntensity Độ xoay

Trả về một chuỗi mô tả độ nhạy xoay camera trong VR: Low , High và Smooth .Điều này sẽ không có sẵn trừ khi VRService.VREnabled là true .

Tham Số

parameterName: string
Giá Trị Mặc Định: ""

Lợi Nhuận

Variant
Xem tất cả các mục kế thừa từ Instance
Xem tất cả các mục kế thừa từ Object

Sự Kiện

Xem tất cả các mục kế thừa từ Instance
Xem tất cả các mục kế thừa từ Object