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 container được thiết kế để chứa LayerCollector đối tượng như ScreenGuis .

Khi một <

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 để kích động cá

Tóm Tắt

Thuộc Tính

ProcessUserInput:bool
Ẩn
Không Sao Chép
Bảo Mật Plugin
Đọc Song Song
Cho phép service này xử lý nhập như PlayerGui và CoreGui làm.
RtlTextSupport:Enum.RtlTextSupport
Không Thể Viết Kịch Bản
Đọc Song Song
ScreenOrientation:Enum.ScreenOrientation
Đọc Song Song
Điều chỉnh chế độ phù hợp màn hình cho người dùng với các thiết bị di động.
ShowDevelopmentGui:bool
Đọc Song Song
Xác định có phải nội dung của StarterGui được hiển thị trong Studio.
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(coreGuiType : Enum.CoreGuiType):bool
Trả lại có phải Enum.CoreGuiType đã được kích hoạt, hoặc nó đã bị tắt bằng cách sử dụng StarterGui:SetCoreGuiEnabled() .
SetCore(parameterName : string,value : Variant):void
Cho phép bạn thực hiện một số hành động nhất định với các tập lệnh trung tâm của Roblox.
SetCoreGuiEnabled(coreGuiType : Enum.CoreGuiType,enabled : bool):void
Đặt whether the CoreGui element associating with the given Enum.CoreGuiType is enabled or disabled.
GetCore(parameterName : string):Variant
Sinh Lợi
Trả lại một biến đổi đã được định bởi một tập lệnh Roblox.

Phương Pháp kế thừa từ BasePlayerGui

GetGuiObjectsAtPosition(x : number,y : number):Instances
Đã trả lại một danh sách các GuiObject instanese đang chiếm phần thời gian trên màn hì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

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

Thuộc Tính

ProcessUserInput

bool

Ẩn

Không Sao Chép

Bảo Mật Plugin

Đọc Song Song

Cho phép StarterGui xử lý nhập như PlayerGui và CoreGui làm. Giá trị mặc định là 1> false1> .

RtlTextSupport

Enum.RtlTextSupport

Không Thể Viết Kịch Bản

Đọc Song Song

ScreenOrientation

Enum.ScreenOrientation

Đọc Song Song

Đặt cấu hình độ đứng 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, hãy xem Enum.ScreenOrientation .

Bởi mặc định, thuộc tính này được đặt là Sensor, có nghĩa là trải nghiệm được hiển thị tùy thuộc vào kết quả trùng phù hợp với hướng tốt nhất của thiết bị, either landscape (bên trái/phải) hoặc portrait.

Khi một Class.Player tham gia vào trải nghiệm trên một thiết bị di động, đặc tính này xác định hướng khởi đầu của thiết bị và thiết lập PlayerGui.ScreenOrientation của ngườ

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

ShowDevelopmentGui

bool

Đọc Song Song

Điều này xác định liệu nội dung của StarterGui có đượ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

bool

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

Lưu ý rằng việc thiết lập "TopbarEnabled" để false bằng cách sử dụng SetCore() ẩn tất cả 1> Enum.CoreGuiType|CoreGuiTypes1> nhưng không ảnh hưởng đến kết quả của chức năng này.

Tham Số

coreGuiType: Enum.CoreGuiType

The given Enum.CoreGuiType .

Lợi Nhuận

bool

Có được sử dụng Enum.CoreGuiType hay không.

Mẫu mã

Checking if a Core GUI is Enabled

local StarterGui = game:GetService("StarterGui")

print(StarterGui:GetCoreGuiEnabled("PlayerList"))

SetCore

void

Phương thức này (không được lẫn 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 script core của Roblox, chẳng hạn như gửi thông báo, bật/tắt thông báo cho các hạng/thời

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 thiết phải gọi phương thức này nhiều lần bằng cách sử dụng pcall() trong trường hợp kị cần thiết core script đã không tải (hoặc nếu nó đã bị tắt hoàn toàn).

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

ChatHoạt động

Kiểm tra xem trò chuyện đang diễn ra hay không.


<tbody>
  <tr>
    <td><code>hoạt động</code></td>
    <td>boolean</td>
    <td>(yêu cầu)</td>
    <td>Xác định liệu trò chuyện có được kích hoạt hay không.</td>
  </tr>
</tbody>

Tên	Kiểu	Mặc định	Mô tả

PointsNotificationsHoạt động

Điều khiển nếu thông báo cho điểm người chơi đã kiếm sẽ xuất hiện.


<tbody>
  <tr>
    <td><code>hoạt động</code></td>
    <td>boolean</td>
    <td>(yêu cầu)</td>
    <td>Xác định nếu có hay không những thông báo đối với điểm người chơi kiếm được.</td>
  </tr>
</tbody>

Tên	Kiểu	Mặc định	Mô tả

BadgesThông báo

Kiểm tra xem thông báo nhận bằng sẽ xuất hiện không.


<tbody>
  <tr>
    <td><code>hoạt động</code></td>
    <td>boolean</td>
    <td>(yêu cầu)</td>
    <td>Xác định nếu có hay không những thông báo được hiển thị cho các huy hiệu đã nhận.</td>
  </tr>
</tbody>

Tên	Kiểu	Mặc định	Mô tả

Hồi gọi ResetButton

Xác định hành vi, nếu có, của nút đặt lại được cho phép hoặc một BindableEvent để bị kích hoạt khi một người yêu cầu trả về mặc định.


<tbody>
  <tr>
    <td><code>đã bật</code></td>
    <td>boolean</td>
    <td>(yêu cầu)</td>
    <td>Xác định ap có được hành vi mặc định của nút đặt lại không.</td>
  </tr>

  <tr>
    <td colspan="4"><b>HOẶC</b></td>
  </tr>

  <tr>
    <td><code>gọi lại</code></td>
    <td><code>Class.BindableEvent</code></td>
    <td>(yêu cầu)</td>
    <td>Một <code>Class.BindableEvent</code> để bắt đầu khi người chơi xác nhận rằng họ muốn trả về mặc định.</td>
  </tr>
</tbody>

Tên	Kiểu	Mặc định	Mô tả

Tin nhắn tạo dựng trò chuyện

Hiển thị một tin nhắn được biểu tượng trong trò chuyện.


<tbody>
  <tr>
    <td><code>bảng cấu hình</code></td>
    <td>từ điển</td>
    <td>(yêu cầu)</td>
    <td>Một từ điển thông tin mô tả thông điệp (xem bên dưới).</td>
  </tr>
</tbody>

Tên	Kiểu	Mặc định	Mô tả


<tbody>
  <tr>
    <td><code>Văn bản</code></td>
    <td>chuỗi</td>
    <td>(yêu cầu)</td>
    <td>Tin nhắn để hiển thị.</td>
  </tr>

  <tr>
    <td><code>Màu sắc</code></td>
    <td><code>Màu.Độ dịch3</code></td>
    <td><code>Datatype.Color3.fromRGB(255, 255, 243)</code></td>
    <td>Màu chữ của thông tin nhắn.</td>
  </tr>

  <tr>
    <td><code>Phông chữ</code></td>
    <td><code>Font.</code></td>
    <td><code>SourceSansBold</code></td>
    <td>Font của thông tin nhắn.</td>
  </tr>

  <tr>
    <td><code>Kích thước chữ</code></td>
    <td>số</td>
    <td><code>18 sản phẩm</code></td>
    <td>Kích thước chữ của thông tin nhắn.</td>
  </tr>
</tbody>

Tên	Kiểu	Mặc định	Mô tả

Gửi thông báo

Gây ra một thông báo không xâm nhập để 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ó hai nút.


<tbody>
  <tr>
    <td><code>bảng cấu hình</code></td>
    <td>từ điển</td>
    <td>(yêu cầu)</td>
    <td>Một từ điển thông tin mô tả thông báo (xem bên dưới).</td>
  </tr>
</tbody>

Tên	Kiểu	Mặc định	Mô tả


<tbody>
  <tr>
    <td><code>Tiêu đề</code></td>
    <td>chuỗi</td>
    <td>(yêu cầu)</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>(yêu cầu)</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>con số</td>
    <td><code>5</code></td>
    <td>Thời gian (in seconds) thông báo nên được giữ nhìn thấy.</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 chữ cái của nút đã được nhấn bởi người người chơi.</td>
  </tr>

  <tr>
    <td><code>Button1:</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>Button2)</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	Kiểu	Mặc định	Mô tả

Topbar đã bật

Xác định có phải hiển thị thanh trên cùng 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ư chat, khovà danh sách người chơi (như các bộ đã được thiết lập với SetCoreGuiEnabled).

Khi bị vô hiệu hóa, thanh bên của trang sẽ vẫn cảm ứng sự kiện chuột; tuy nhiên, các nút được đặt ở đó sẽ không phản hồi đến các lần nhấp chuột. Kích thước của không gian GUI sẽ vẫn được lùi 36 pixel từ đầu màn hình.


<tbody>
  <tr>
    <td><code>đã bật</code></td>
    <td>boolean</td>
    <td>(yêu cầu)</td>
    <td>Xác định có nên hiển thị thanh trên cùng không.</td>
  </tr>
</tbody>

Tên	Kiểu	Mặc định	Mô tả

DevConsoleHiển thị

Xác định có phải Developer Console có thể được nhìn thấy.


<tbody>
  <tr>
    <td><code>hiển thị</code></td>
    <td>boolean</td>
    <td>(yêu cầu)</td>
    <td>Xác định có phải hiển thị màn hình chính hay không.</td>
  </tr>
</tbody>

Tên	Kiểu	Mặc định	Mô tả

Yêu cầu gửi bạn bè

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


<tbody>
  <tr>
    <td><code>người chơi</code></td>
    <td><code>Class.Player</code></td>
    <td>(yêu cầu)</td>
    <td>Người chơi mà bạn yêu cầu gửi lời mời nên được khoản</td>
  </tr>
</tbody>

Tên	Kiểu	Mặc định	Mô tả

Yêu cầu bạn bè không

Yêu cầu người chơi hiện tại xóa một Player nào đó khỏi danh sách bạn bè của họ.


<tbody>
  <tr>
    <td><code>người chơi</code></td>
    <td><code>Class.Player</code></td>
    <td>(yêu cầu)</td>
    <td>Người chơi mà bạn nên bỏ bạn bè.</td>
  </tr>
</tbody>

Tên	Kiểu	Mặc định	Mô tả

Khối lập trình

Yêu cầu người chơi hiện tại để chặn các điều khoản đã được cung cấp Player .


<tbody>
  <tr>
    <td><code>người chơi</code></td>
    <td><code>Class.Player</code></td>
    <td>(yêu cầu)</td>
    <td>Người chơi nên được chặn.</td>
  </tr>
</tbody>

Tên	Kiểu	Mặc định	Mô tả

Kêu gọi bỏ chặn người chơi

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


<tbody>
  <tr>
    <td><code>người chơi</code></td>
    <td><code>Class.Player</code></td>
    <td>(yêu cầu)</td>
    <td>Người chơi mà không nên bị unblocked.</td>
  </tr>
</tbody>

Tên	Kiểu	Mặc định	Mô tả

Mục đơn Avatar bật

Xác định có phải Avatar Context Menu được kích hoạt.


<tbody>
  <tr>
    <td><code>đã bật</code></td>
    <td>boolean</td>
    <td>(yêu cầu)</td>
    <td>Xác định có phải mở màn hình Kontext.</td>
  </tr>
</tbody>

Tên	Kiểu	Mặc định	Mô tả

Mục tiêu Avatar Context Menu

Bằng lực mở Avatar Context Menu .


<tbody>
  <tr>
    <td><code>người chơi</code></td>
    <td><code>Class.Player</code></td>
    <td>(yêu cầu)</td>
    <td>Người chơi mà màn hình ngữ cảnh sẽ được mở.</td>
  </tr>
</tbody>

Tên	Kiểu	Mặc định	Mô tả

ThêmCài Đặt Avatar

Thêm một tùy chọn vào Avatar Context Menu .


<tbody>
  <tr>
    <td><code>lựa chọn</code></td>
    <td><code>Menu.Avatar ContextMenuOption</code></td>
    <td>(yêu cầu)</td>
    <td>Lựa chọn thêm.</td>
  </tr>

  <tr>
    <td colspan="4"><b>HOẶC</b></td>
  </tr>

  <tr>
    <td><code>lựa chọn</code></td>
    <td>bảng</td>
    <td>(yêu cầu)</td>
    <td>Một bảng hai yếu tố, trong đó yếu tố đầu tiên là tên hành động tùy chỉnh, và yếu tố thứ hai là một <code>Class.BindableEvent</code> sẽ được kích hoạt với một người chơi đã được chọn khi tùy chọn được kích hoạt.</td>
  </tr>
</tbody>

Tên	Kiểu	Mặc định	Mô tả

Loại bỏ Avatar Context Menu Option

Loại bỏ một tùy chọn đến Avatar Context Menu . The option argument must be the same as what was used with "AddAvatarContextMenuOption" (xem trên).


<tbody>
  <tr>
    <td><code>lựa chọn</code></td>
    <td>Biến thể</td>
    <td>(yêu cầu)</td>
    <td>Giá trị tương tự được cung cấp cho <b>AddAvatarContextMenuOption</b> .</td>
  </tr>
</tbody>

Tên	Kiểu	Mặc định	Mô tả

Trang chủ Avatar Context Menu

Tùy chỉnh Avatar Context Menu tùy chỉnh mà người chơi có thể dễ dàng tương tác với nhau qua các hành động tùy chỉnh, chẳng hạn như khởi xướng giao dịch, trận đấu 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

Mối quan hệ CoreGuiChat

Tạo một kết nối gateway kết nối giữa CoreGui topbar's chat button và hệ thống chat truyền thống. Tham số thứ hai phải là một bảng BindableEvents và BindableFunctions .

Tham Số

parameterName: string

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

value: Variant

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

Lợi Nhuận

void

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

void

Hành động này đặt liệu có phải mục đã liên kết với CoreGui hay không.

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

Tham Số

coreGuiType: Enum.CoreGuiType

The given Enum.CoreGuiType .

enabled: bool

Có để bật hoặc tắt Enum.CoreGuiType đã được cung cấp.

Lợi Nhuận

void

GetCore

Variant

Sinh Lợi

Phương thức này trả về bộ dữ liệu đã được tạo hoặc đã được lập trình sẵn bởi các script trung tâm của Roblox. Phần thứ nhất và duy nhất là một chuỗi chọn thông tin để được lấy. Các mục tiếp theo mô tả các chuỗi và dữ liệu mà nó trả bởi chức năng này.

Gọi phương thức này có thể được. Nhiều trong số này cũng đăng nhập một đối tượng tương đương SetCore() 함수 (các đối tượng này được xếp chồng với một dấu chấm câu).

PointsNotificationsActive *

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

BadgesNotificationsActive *

Trả lại true nếu báo hiệu bản hiệu chỉ được kích hoạt khi bản hiệu chỉ được kích hoạt.

AvatarContextMenuĐã bật *

Trả lại true nếu Avatar Context Menu được kích hoạt.

ChatHoạt động *

Trả lại có hay không nếu cuộc trò chuyện đang diễn ra hay không. Điều này được thể hiện bằng trạng thái lựa chọn của biểu tượng trò chuyện ở thanh bên trên của màn hình.

Kích cỡ cửa sổ trò chuyện *

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

Vị trí Cửa sổ *

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

ChatBarDisabled *

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

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

Đã trả lại một danh sách UserIds liên quan đến người dùng đã bị chặn bởi người chơi địa phương.

Sự kiện đã chặn

Làm trả một BindableEvent được kích hoạt mỗi khi một người chơi bị chặn bởi người chơi địa phương.

Sự kiện đã được mở khóa

Làm trả lại một Class.BindableEvent BindableEvent được kích hoạt bằng cách bỏ chặn một người chơi bằng cách sử dụng người chơi địa phương.

Sự kiện đã tắt

Làm trả lại một Class.BindableEvent BindableEvent được kích hoạt khi một người chơi bị tắt tiếng bởi người chơi địa phương.

Sự kiện không muốn chơi

Làm trả lại một Class.BindableEvent BindableEvent được kích hoạt mỗi khi một người chơi được bỏ chặn bởi người chơi địa phương.

Sự kiện bạn bè

Làm trả lại một Class.BindableEvent BindableEvent được kích hoạt mỗi khi một người chơi được bạn bè bởi người chơi địa phương.

Sự kiện không bạn bè

Làm trở lại một Class.BindableEvent BindableEvent được kích hoạt mỗi khi một người chơi bị bỏ bạn bởi người chơi địa phương.

DevConsoleHiển thị *

Trả lại true nếu Developer Console có thể nhìn thấy.

Độ rung VR

Trả lại một chuỗi mô tả sự nhạy bén của máy ảnh trong VR: Low, High và Smooth. Điều này sẽ không khả dụng trừ khi 1> Class.VRService.VREnabled1> là 4> true4> .

Tham Số

parameterName: string

Lợi Nhuận

Variant

Thuộc Tính được 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

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