StarterGui

사용되지 않는 항목 표시

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

만들 수 없음
서비스

StarterGui 는 LayerCollector 개체와 같은 개체를 더 작은 컨테이너에 보관하도록 설계된 컨테이너 개체입니다.

StarterGui 는 또한 CoreGui 와 상호 작용할 수 있는 범위의 기능을 포함합니다. 예를 들어, StarterGui:SetCoreGuiEnabled() 는 알림을 생성하고 시스템 메시지를 수신하는 등의

요약

속성

Instance에서 상속된 모든 항목 보기
Object에서 상속된 모든 항목 보기

메서드

메서드가 BasePlayerGui에서 상속되었습니다
Instance에서 상속된 모든 항목 보기
Object에서 상속된 모든 항목 보기

속성

ProcessUserInput

bool
숨김
복제되지 않음
플러그인 보안
병렬 읽기

StarterGui 가 입력을 처리하는 방식을 PlayerGui 및 CoreGui 와 같이 처리할 수 있습니다. 기본값은 1> false 1> 입니다.

RtlTextSupport

Enum.RtlTextSupport
스크립팅할 수 없음
병렬 읽기

ScreenOrientation

Enum.ScreenOrientation
병렬 읽기

이 속성은 모바일 장치의 사용자에게 권장되는 화면 지향 모드를 설정합니다. 사용 가능한 다른 모드는 Enum.ScreenOrientation 을 참조하십시오.

기본적으로 이 속성은 Sensor 로 설정되어 있으며, 경험은 기기현재 방향에 따라 랜드스케이프(왼쪽/오른쪽) 또는 포트레이트(왼쪽)로 표시됩니다.

Class.Player 가 모바일 기기경험에 참여하면 이 속성은 기기시작 방향을 결정하고 해당 플레이어의 PlayerGui.ScreenOrientation 을 설정합니다. 또한, PlayerGui.CurrentScreenOrientation 를 통해

이 속성을 변경하면 경험에 이미 있는 Players의 화면 지향을 변경하지 않습니다. 기존 플레이어의 경우 PlayerGui.ScreenOrientation 속성을 사용하여 지향을 변경하십시오.

ShowDevelopmentGui

bool
병렬 읽기

이 속성은 StarterGui의 콘텐츠가 Studio에서 표시되는지 여부를 결정합니다.

VirtualCursorMode

Enum.VirtualCursorMode
스크립팅할 수 없음
병렬 읽기
Instance에서 상속된 모든 항목 보기
Object에서 상속된 모든 항목 보기

메서드

GetCoreGuiEnabled

bool

이 함수는 지정한 Enum.CoreGuiType 이 활성화되었는지 여부를 반환하거나, StarterGui:SetCoreGuiEnabled() 를 사용하여 활성화되었는지 여부를 표시합니다. 이 함수는 클라이언트에서 호출해야 합니다.

Class.StarterGui:SetCore()|SetCore()를 사용하여 false 에 모든 SetCore() 을 숨기지만 이 함수의 결과에는 영향을 주지 않습니다.

매개 변수

coreGuiType: Enum.CoreGuiType

지정된 Enum.CoreGuiType .


반환

bool

지정된 Enum.CoreGuiType 이 활성화되었는지 여부.

코드 샘플

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



print(StarterGui:GetCoreGuiEnabled("PlayerList"))

SetCore

void

이 메서드(SetCoreGuiEnabled() 와 혼동하지 마십시오)는 Roblox 코어 스크립트의 다양한 기능을 노출합니다, 예를 들어 알림 전송, 배지/포인트 전환 알림 정의, 초기화 버튼에 대한 콜백 정의 또는 상단 표시줄 전환.

첫 번째 매개 변수는 호출과 상호 작용할 기능을 선택하는 문자열입니다. 특정 코어 스크립트가 로드되지 않은 경우 이 메서드를 여러 번 호출해야 할 수 있습니다(또는 완전히 비활성화되었습니다). The first parameter is a string that selects the functionality with which the call will interact. It may be necessary to call this method multiple times using pcall() in case the respective core script has

다음 표에서는 첫 번째 매개 변수로 허용되는 문자열을 설명합니다. 다음에 나오는 매개 변수는 사용할 기능에 따라 설명되며 하위 테이블에 설명됩니다.

채팅 활성

채팅이 활성인지 여부를 제어합니다.

<tbody>

  <tr>

    <td><code>활성화된</code></td>

    <td>부울</td>

    <td>(필수)</td>

    <td>채팅을 활성화할지 여부를 결정합니다.</td>

  </tr>

</tbody>
이름유형기본설명
포인트 알림 활성화

플레이어 포인트를 획득한 경우 알림이 표시되는지 여부를 제어합니다.

<tbody>

  <tr>

    <td><code>활성화된</code></td>

    <td>부울</td>

    <td>(필수)</td>

    <td>플레이어 포인트를 획득한 경우 알림이 표시되는지 여부를 결정합니다.</td>

  </tr>

</tbody>
이름유형기본설명
배지 알림 활성화

획득한 배지에 대한 알림이 표시되는지 여부를 제어합니다.

<tbody>

  <tr>

    <td><code>활성화된</code></td>

    <td>부울</td>

    <td>(필수)</td>

    <td>획득한 배지에 대한 알림이 표시되는지 여부를 결정합니다.</td>

  </tr>

</tbody>
이름유형기본설명
초기화 버튼 콜백

플레이어가 초기화할 때 발생할 수 있는 버튼의 동작을 결정합니다. 버튼에 부울 또는 BindableEvent 를 지정하면 플레이어가 재설정요청할 때 해당 버튼을 발동시킵니다.

<tbody>

  <tr>

    <td><code>활성화되었습니다</code></td>

    <td>부울</td>

    <td>(필수)</td>

    <td>초기화 버튼이 기본 동작을 유지하는지 여부를 결정합니다.</td>

  </tr>



  <tr>

    <td colspan="4"><b>또는</b></td>

  </tr>



  <tr>

    <td><code>콜백</code></td>

    <td><code>Class.BindableEvent</code></td>

    <td>(필수)</td>

    <td>플레이어가 재설정확인할 때 <code>Class.BindableEvent</code>를 발사합니다.</td>

  </tr>

</tbody>
이름유형기본설명
채팅 메이크 시스템 메시지

채팅에 서식 지정된 메시지 표시.

<tbody>

  <tr>

    <td><code>구성 테이블</code></td>

    <td>사전</td>

    <td>(필수)</td>

    <td>아래에 설명된 메시지를 설명하는 사전입니다.</td>

  </tr>

</tbody>
이름유형기본설명
<tbody>

  <tr>

    <td><code>텍스트</code></td>

    <td>문자열</td>

    <td>(필수)</td>

    <td>표시할 메시지.</td>

  </tr>



  <tr>

    <td><code>색상</code></td>

    <td><code>Datatype.Color3</code></td>

    <td><code>Datatype.Color3.fromRGB(255, 255, 243)</code></td>

    <td>메시지의 텍스트 색상.</td>

  </tr>



  <tr>

    <td><code>글꼴</code></td>

    <td><code>Font.Font 열거형</code></td>

    <td><code>SourceSansBold</code></td>

    <td>메시지의 글꼴.</td>

  </tr>



  <tr>

    <td><code>텍스트 크기</code></td>

    <td>정수</td>

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

    <td>메시지의 텍스트 크기입니다.</td>

  </tr>

</tbody>
이름유형기본설명
알림 전송

화면 오른쪽 하단에 표시되는 비침습 알림을 일으킵니다. 알림에는 최대 두 개의 버튼이 있을 수 있습니다.

<tbody>

  <tr>

    <td><code>구성 테이블</code></td>

    <td>사전</td>

    <td>(필수)</td>

    <td>알림에 대한 정보를 설명하는 사전(아래 참조).</td>

  </tr>

</tbody>
이름유형기본설명
<tbody>

  <tr>

    <td><code>타이틀</code></td>

    <td>문자열</td>

    <td>(필수)</td>

    <td>알림의 제목.</td>

  </tr>



  <tr>

    <td><code>텍스트</code></td>

    <td>문자열</td>

    <td>(필수)</td>

    <td>알림의 주요 텍스트.</td>

  </tr>



  <tr>

    <td><code>아이콘</code></td>

    <td>문자열</td>



    <td />



    <td>알림과 함께 표시할 이미지입니다.</td>

  </tr>



  <tr>

    <td><code>지속 시간</code></td>

    <td>숫자</td>

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

    <td>알림이 표시되는 지속 시간(초).</td>

  </tr>



  <tr>

    <td><code>콜백</code></td>

    <td><code>Class.BindableFunction</code></td>



    <td />



    <td>플레이어가 누른 버튼의 텍스트와 함께 호출해야 하는 <code>Class.BindableFunction</code>입니다.</td>

  </tr>



  <tr>

    <td><code>버튼1</code></td>

    <td>문자열</td>



    <td />



    <td>첫 번째 버튼에 표시할 텍스트입니다.</td>

  </tr>



  <tr>

    <td><code>버튼2</code></td>

    <td>문자열</td>



    <td />



    <td>두 번째 버튼에 표시할 텍스트.</td>

  </tr>

</tbody>
이름유형기본설명
상단 표시 줄 활성화

상단 표시 줄이 표시되는지 여부를 결정합니다. 상단 표시 줄을 비활성화하면 채팅, 인벤토리 및 플레이어 목록과 같은 모든 CoreGuis 가 비활성화됩니다(예: SetCoreGuiEnabled).

비활성화되면 상단 표시줄에 있던 영역이 여전히 마우스 이벤트를 캡처하지만, 배치된 버튼은 클릭에 응답하지 않습니다. GUI 공간의 원본은 여전히 화면 상단의 36픽셀 오프셋에서 오게 됩니다.

<tbody>

  <tr>

    <td><code>활성화되었습니다</code></td>

    <td>부울</td>

    <td>(필수)</td>

    <td>상단 표시 줄이 표시되어야 하는지 여부를 결정합니다.</td>

  </tr>

</tbody>
이름유형기본설명
DevConsoleVisible

개발자 콘솔 이 표시되는지 여부를 결정합니다.

<tbody>

  <tr>

    <td><code>시각성</code></td>

    <td>부울</td>

    <td>(필수)</td>

    <td>콘솔이 표시되는지 여부를 결정합니다.</td>

  </tr>

</tbody>
이름유형기본설명
친구 요청 전송

현재 플레이어에게 친구 요청을 보내는 것을 친구 Player 에 요청합니다.

<tbody>

  <tr>

    <td><code>플레이어</code></td>

    <td><code>Class.Player</code></td>

    <td>(필수)</td>

    <td>친구 요청을 보낼 플레이어를 선택합니다.</td>

  </tr>

</tbody>
이름유형기본설명
친구 해제

현재 플레이어에게 지정된 Player를 친구 목록에서 제거하도록 요청합니다.

<tbody>

  <tr>

    <td><code>플레이어</code></td>

    <td><code>Class.Player</code></td>

    <td>(필수)</td>

    <td>친구를 해제해야 하는 플레이어입니다.</td>

  </tr>

</tbody>
이름유형기본설명
프롬프트 블록 플레이어

현재 플레이어에게 지정된 Player 을 블록하도록 요청합니다.

<tbody>

  <tr>

    <td><code>플레이어</code></td>

    <td><code>Class.Player</code></td>

    <td>(필수)</td>

    <td>차단해야 하는 플레이어.</td>

  </tr>

</tbody>
이름유형기본설명
PromptUnblockPlayer

현재 플레이어에게 지정된 Player 을 차단 해제하라는 메시지를 표시합니다.

<tbody>

  <tr>

    <td><code>플레이어</code></td>

    <td><code>Class.Player</code></td>

    <td>(필수)</td>

    <td>차단해야 할 플레이어입니다.</td>

  </tr>

</tbody>
이름유형기본설명
아바타 컨텍스트 메뉴 활성화

아바타 컨텍스트 메뉴 가 활성화되는지 여부를 결정합니다.

<tbody>

  <tr>

    <td><code>활성화되었습니다</code></td>

    <td>부울</td>

    <td>(필수)</td>

    <td>컨텍스트 메뉴가 활성화되는지 여부를 결정합니다.</td>

  </tr>

</tbody>
이름유형기본설명
아바타 컨텍스트 메뉴 대상

자동으로 아바타 컨텍스트 메뉴를 엽니다.

<tbody>

  <tr>

    <td><code>플레이어</code></td>

    <td><code>Class.Player</code></td>

    <td>(필수)</td>

    <td>컨텍스트 메뉴가 열릴 플레이어입니다.</td>

  </tr>

</tbody>
이름유형기본설명
아바타 컨텍스트 메뉴 옵션 추가

옵션을 아바타 컨텍스트 메뉴에 추가합니다.

<tbody>

  <tr>

    <td><code>옵션</code></td>

    <td><code>Enum.AvatarContextMenuOption</code></td>

    <td>(필수)</td>

    <td>옵션을 추가할 수 있습니다.</td>

  </tr>



  <tr>

    <td colspan="4"><b>또는</b></td>

  </tr>



  <tr>

    <td><code>옵션</code></td>

    <td>테이블</td>

    <td>(필수)</td>

    <td>두 요소 테이블, 첫 번째는 사용자 지정 액션의 이름이고 두 번째는 <code>Class.BindableEvent</code>이며 옵션이 활성화된 플레이어가 선택한 클래스에 발射됩니다.</td>

  </tr>

</tbody>
이름유형기본설명
아바타 컨텍스트 메뉴 옵션 제거

아바타 컨텍스트 메뉴 에 옵션을 제거합니다. option 인수는 "AddAvatarContextMenuOption" (위에 참조) 와 동일해야 합니다.

<tbody>

  <tr>

    <td><code>옵션</code></td>

    <td>변형</td>

    <td>(필수)</td>

    <td>같은 값을 <b>AvatarContextMenuOption</b>에 제공합니다.</td>

  </tr>

</tbody>
이름유형기본설명
아바타 컨텍스트 메뉴 테마

사용자 지정 가능한 아바타 컨텍스트 메뉴 는 트레이드, 전투 및 기타 사용자 간 소셜 상호 작용을 위한 맞춤형 액션과 같은 옵션인 플레이어 간 소셜 상호 작용을 쉽게 할 수 있는 옵션 인 핵심 메뉴입니다. 테마를 사용자 정의하

코어 가이 채팅 연결

Class.CoreGui 상단 표시 줄의 채팅 버튼과 전통 채팅 시스템 사이에서 바인딩 가능한 게이트웨이 연결을 설정합니다. 두 번째 매개 변수는 BindableEvents 및 BindableFunctions 테이블이어야 합니다.

매개 변수

parameterName: string

호출이 상호 작용할 기능을 선택합니다.

value: Variant

Class.BindableEvent|BindableEvents 및 BindableFunctions 의 테이블.


반환

void

코드 샘플

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

이 함수는 CoreGui 요소가 제공된 Enum.CoreGuiType와 연관된 경우 활성화 또는 비활성화됩니다.

상단 표시줄을 이 함수를 사용하여 비활성화할 수 없습니다. 이를 비활성화하려면 "TopbarEnabled" 를 사용하여 false 를 StarterGui:SetCore() 으로 설정하십시오.

매개 변수

coreGuiType: Enum.CoreGuiType

지정된 Enum.CoreGuiType .

enabled: bool

제공된 Enum.CoreGuiType 을 활성화하거나 비활성화합니다.


반환

void

GetCore

Variant
생성

이 메서드는 Roblox 코어 스크립트에서 데이터 집합을 반환하거나 사용할 수 있는 메서드입니다. 첫 번째 매개 변수는 검색할 정보를 선택하는 문자열입니다. 다음 섹션에서는 이 함수에서 반환하는 문자열 및 데이터에 대해 설명합니다.

이 메서드를 호출하면 다음이 생성될 수 있습니다. 많은 의 이 메서드는 해당 함수의 상당한 부분을 기록합니다. (이 함수는 별표로 표시됩니다).

포인트 알림 활성화 *

플레이어 포인트 알림이 활성화된 경우 true 을 반환합니다.

배지 알림 활성화 *

배지 알림이 활성화되면 true 을 반환합니다.

아바타 컨텍스트 메뉴 활성화 *

아바타 컨텍스트 메뉴가 활성화된 경우 true를 반환합니다.

채팅 활성화*

채팅이 활성인지 여부를 반환합니다. 상단 표시 줄의 채팅 아이콘 상태에 따라 표시됩니다.

채팅 창 크기 *

채팅 창의 크기를 UDim2 로 반환합니다.

채팅 창 위치 *

채팅 창의 크기를 UDim2 로 반환합니다.

채팅 바 비활성화 *

채팅 바가 비활성화된 경우 true 을 반환합니다.

GetBlockedUserIds 를 얻습니다.

로컬 플레이어가 차단한 사용자와 관련된 UserIds 목록을 반환합니다.

차단된 플레이어 이벤트

플레이어가 로컬 플레이어에 의해 차단되면 발생하는 BindableEvent를 반환합니다.

플레이어 비 블록 이벤트

플레이어가 로컬 플레이어에 의해 언블록 해제될 때마다 실행되는 BindableEvent를 반환합니다.

플레이어 음소거 이벤트

로컬 플레이어에 의해 음소거되면 발생하는 BindableEvent를 반환합니다.

PlayerUnmutedEvent

로컬 플레이어가 묵시적으로 해제되면 플레이어가 언뮤티드 해제된 때마다 BindableEvent 을 반환합니다.

플레이어 친화 이벤트

로컬 플레이어에 의해 친구가 되면 발생하는 BindableEvent를 반환합니다.

플레이어 친구 해제 이벤트

로컬 플레이어가 플레이어를 친구 해제할 때 발생하는 BindableEvent를 반환합니다.

DevConsoleVisible *

개발자 콘솔이 표시되면 true 를 반환합니다.

VRRotationIntensity

VR에서 카메라 회전 민감도를 설명하는 문자열을 반환합니다. Low, High 및 Smooth. 이 기능은 클래스 1>VRService.VREnabled1>가 아니라면 4>트루4>가 될 수 없습니다.

매개 변수

parameterName: string

반환

Variant
Instance에서 상속된 모든 항목 보기
Object에서 상속된 모든 항목 보기

이벤트

Instance에서 상속된 모든 항목 보기
Object에서 상속된 모든 항목 보기