셀카 모드

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

플레이어는 이미 경험의 재미있는 순간을 기념하기 위해 스크린샷을 찍습니다. 셀카모드 개발자 모듈 은 채팅 창이나 플레이어 목록 없이 플레이어가 그 순간의 더 깨끗한 메모리를 캡처할 수 있게 하면서 필터 효과, 다른 캐릭터의 숨기기, 포즈를 지원합니다.

모듈 사용량

설치

경험에서 셀카 모드 모듈을 사용하려면:

  1. 보기 탭에서 도구 상자 를 열고 크리에이터 스토어 탭을 선택합니다.

    Toolbox toggle button in Studio
  2. 모델 정렬이 선택되었는지 확인한 다음 모두 보기 버튼을 클릭하여 카테고리를 확인하십시오.

  3. 찾아서 클릭하십시오 개발자 모듈 타일.

  4. 셀카 모드 모듈을 찾아 클릭하거나 3D 뷰에 드래그 앤 드롭하세요.

  5. 탐색기 창에서 전체 SelfieMode 모델을 ServerScriptService로 이동합니다.경험을 실행하면 모듈이 다양한 서비스에 배포되고 실행을 시작합니다.

구성

모듈은 대부분의 사용 사례에서 작동하도록 미리 구성되었지만 configure 함수를 통해 쉽게 사용자 지정할 수 있습니다.

  1. In 스타터 플레이어 스크립트 , 새로운 LocalScript 를 생성하고 셀카 모드 구성 으로 이름을 변경합니다.

  2. 새 스크립트에 다음 코드를 붙여넣습니다.

    로컬스크립트 - 셀카 모드 구성

    local ReplicatedStorage = game:GetService("ReplicatedStorage")
    local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
    SelfieMode.configure({
    disableCharacterMovement = true
    })

캐릭터 이동

셀카 모드에서 플레이어의 캐릭터가 이동하지 않도록 방지하는 것이 유리할 수 있습니다.disableCharacterMovement 호출에서 설정을 true로 설정하여 이를 달성할 수 있습니다.

로컬스크립트 - 셀카 모드 구성

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.configure({
disableCharacterMovement = true
})

셀카 모드 작업

셀카 모드 는 다음 작업을 갖추고 있으며, 각각 activateAction , deactivateActiontoggleAction 기능을 사용하거나 actionActivatedactionDeactivated 이벤트를 통해 감지할 수 있습니다.

필드 깊이

기본적으로, 셀카 모드 는 플레이어가 작업을 전환할 때 일반적인 필드 깊이 효과(배경의 미묘한 흐림)를 표시합니다.

기본 필드 깊이 효과를 변경하려면 depthOfFieldEffectDepthOfFieldEffect 인스턴스에서 구성 호출에 설정하십시오.

로컬스크립트 - 셀카 모드 구성

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
local customDepthOfField = Instance.new("DepthOfFieldEffect")
customDepthOfField.NearIntensity = 0
customDepthOfField.FarIntensity = 1
customDepthOfField.FocusDistance = 5
customDepthOfField.InFocusRadius = 5
SelfieMode.configure({
depthOfFieldEffect = customDepthOfField
})

시선 잠금

시선 잠금 토글은 플레이어의 캐릭터가 목을 얼마나 멀리 돌릴 수 있는지의 현실적인 범위 내에서 셀카 포즈를 설정하는 동안 카메라를 바라보도록 합니다.

다른 사람 숨기기

기본적으로 다른 캐릭터는 플레이어의 캐릭터 옆에 표시됩니다.플레이어는 다른 사람 숨기기 버튼을 클릭하여 완벽한 솔로 샷을 얻을 수 있다.켜면 다른 캐릭터가 눈에서 사라지고 작업이 끄기로 전환될 때까지 보이지 않습니다.

필터

필터 작업 은 플레이어가 옵션 팝, 소프트, 앤티크, 귀여운, 드라마틱, 및 모노크롬에서 미리 정의된 필터를 적용할 수 있게 합니다.

포즈

포즈 동작은 플레이어가 옵션 응원, 박수, 돌고래, 플로스, 기타, 점프 웨이브, 더 크게, 톱 록, 트위블, 및 웨이브에서 미리 정의된 포즈를 선택할 수 있습니다.

API 참조

유형

액션

각 작업은 다음 키-값 쌍으로 대표되는 사전으로 표시됩니다:

유형설명
name문자열도구 설명에서 먼저 표시되는 액션이름.
description문자열도구 설명에서 이름 뒤에 표시되는 액션설명. name 후에 표시됩니다.
icon문자열액션의 아이콘에 대한 자산 ID.
activeIcon문자열활성 상태에서 액션아이콘에 대한 자산 ID. 하위 작업에는 사용할 수 없으며 부모 작업에만 사용할 수 있습니다.
actions테이블선택적 하위 작업 목록. 이를 통해 다양한 다른 작업의 하위 메뉴를 만들 수 있습니다.
parent액션액션부모; 이는 하위 동작에만 적용되며 그 안에 포함된 동작을 가리킵니다.
onActivated함수플레이어가 액션이나 하위 액션을 활성화할 때 실행되는 선택적 콜백 함수.일반적으로 액션에 하위 작업이 포함되어 있으면 플레이어가 하위 작업을 활성화했는지 알 수 있는 방법으로 정의된 콜백만 하위 작업에 필요하고 부모 작업을 단순히 "확장"하지 않았습니다.
로컬 스크립트

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.actionActivated:Connect(function(action)
print(action.name, "activated")
end)
SelfieMode.actionDeactivated:Connect(function(action)
print(action.name, "deactivated")
end)

열거형

셀카 모드.Action

셀카 모드 는 여러 가지 작업 이 있습니다.이 열거형은 activateAction, deactivateActiontoggleAction 함수와 함께 사용할 수 있습니다.

이름요약
DepthOfField깊이 필드 액션대한 참조.
LockGaze시선 잠금 액션대한 참조.
HideOthers다른 사람 숨기기 액션대한 참조.
Filter필터 액션대한 참조.
Pose포즈 액션대한 참조.
로컬 스크립트

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
-- 필터 액션활성화
SelfieMode.activateAction(SelfieMode.Action.Filter)

함수

구성

구성(config: table)

기본 구성 옵션을 다음 키/값을 통해 재정의합니다 config 테이블에서.이 함수는 LocalScript 호출할 수 있습니다.

설명기본
disableCharacterMovementtrue이면 셀카 모드가 열려 있는 동안 캐릭터가 이동하지 않습니다.거짓
depthOfFieldEffect옵션 사용자 지정 DepthOfFieldEffect 인스턴스가 플레이어가 필드 깊이 작업을 전환할 때 나타납니다.
로컬스크립트 - 셀카 모드 구성

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.configure({
disableCharacterMovement = true
})

오픈셀카모드

오픈셀카모드()

플레이어는 일반적으로 화면 오른쪽의 "카메라" 버튼으로 셀카 모드를 열지만, 이 함수를 통해 코드로 열 수 있습니다.아래에 표시된 대로 사용자 지정 버튼을 구현할 때 setHudButtonEnabled를 통해 기본 버튼을 비활성화해야 합니다.이 함수는 LocalScript 호출할 수 있습니다.

로컬 스크립트

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
local button = script.Parent
-- 기본 버튼 제거
SelfieMode.setHudButtonEnabled(false)
-- 사용자 지정 버튼 연결
button.Activated:Connect(function()
SelfieMode.openSelfieMode()
end)

자가 촬영 모드 닫기 closeSelfieMode

자체 셀카 모드 닫기() closeSelfieMode()

플레이어는 일반적으로 화면 하단의 버튼으로 셀카 모드를 닫지만, 이 함수를 통해 코드로 닫을 수 있습니다.LocalScript

로컬 스크립트

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.closeSelfieMode()

자기 사진 모드 열기 isSelfieModeOpen

isSelfieModeOpen(): boolean

플레이어 작업 또는 openSelfieMode을 통해 셀카 모드가 열려 있으면 true 반환합니다.이 함수는 LocalScript

로컬 스크립트

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.openSelfieMode()
print(SelfieMode.isSelfieModeOpen())

setHudButtonEnabled

setHudButtonEnabled()

기본 버튼이 셀카 모드로 들어가도록 표시되는지 여부를 설정합니다.사용자 지정 UI 버튼을 통해 openSelfieMode를 구현할 때 유용합니다.이 함수는 LocalScript 호출할 수 있습니다.

로컬 스크립트

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
local button = script.Parent
-- 기본 버튼 제거
SelfieMode.setHudButtonEnabled(false)
-- 사용자 지정 버튼 연결
button.Activated:Connect(function()
SelfieMode.openSelfieMode()
end)

액션 가져오기

getAction(action: 셀카모드 액션 ): 액션

SelfieMode.Action 열거형을 통해 액션 유형을 가져옵니다.

로컬 스크립트

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
local lockGazeAction = SelfieMode.getAction(SelfieMode.Action.LockGaze)

활성화된 액션

activateAction(action: 셀카 모드 액션 )

프로그래밍 방식으로 기본 액션 중 하나를 활성화합니다.플레이어가 작업 표시줄에서 작업을 전환할 때와 동일합니다.LocalScript

로컬 스크립트

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
-- 필터 액션활성화
SelfieMode.activateAction(SelfieMode.Action.Filter)

액션 비활성화 deactivateAction

deactivateAction(action: 셀카 모드 액션)

프로그래밍 방식으로 기본 액션 중 하나를 비활성화합니다.플레이어가 액션 바에서 액션을 끄면과 동일합니다.LocalScript

로컬 스크립트

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
-- 필터" 작업 액션
SelfieMode.deactivateAction(SelfieMode.Action.Filter)

액션 전환 toggleAction

toggleAction(action: 셀카모드.액션 ): boolean

꺼져 있으면 액션을 끄기, 켜져 있으면 토글합니다.플레이어가 액션 바에서 액션을 클릭할 때와 동일합니다.새로운 "isToggleOn" 상태를 부울로 반환합니다.LocalScript

로컬 스크립트

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
local lockGazeAction = SelfieMode.getAction(SelfieMode.Action.LockGaze)
local isEnabled = SelfieMode.toggleAction(lockGazeAction)
if isEnabled then
print("Activated", lockGazeAction.name)
else
print("Deactivated", lockGazeAction.name)
end

테마 설정

setTheme(테마: table)

텍스트 크기, 폰트, 버튼/팁 색상 등 셀카 모드 테마를 구성합니다. 이 함수는 LocalScript 호출할 수 있습니다.

설명기본
textSize모든 텍스트의 크기.16
font모든 UI에서 사용되는 폰트(Enum.Font).GothamMedium
paddingUI 요소 레이아웃에 사용되는 기본 패딩(UDim).(0, 12)
paddingSmall요소 간의 미묘한 마진을 적용하는 데 사용되는 더 작은 여백(UDim).(0, 6)
paddingScreen자기 사진 모드에 약간의 호흡 공간을 제공하기 위해 화면 가장자리에 사용되는 여백(UDim).(0, 24)
backgroundColor작업을 표시하는 바의 배경색(Color3).[0, 0, 0]
scrollBarColor모듈의 ScrollingFrame 요소에 사용되는 스크롤바의 색 (Color3).[255, 255, 255]
로컬 스크립트

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.setTheme({
textSize = 20,
font = Enum.Font.Michroma,
backgroundColor = Color3.fromRGB(0, 40, 75),
})

설정된 활성화

setEnabled(isEnabled: boolean )

셀카 모드가 활성화되었는지 여부를 설정합니다.비활성화되면 모듈의 모든 UI가 제거되고 모든 이벤트가 연결 해제됩니다.이 함수는 LocalScript 호출할 수 있습니다.

로컬 스크립트

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.setEnabled(false)

이벤트

셀카 모드 열림

플레이어가 셀카 모드를 열거나 openSelfieMode가 호출될 때 화재가 발생합니다. 이 이벤트는 연결할 수 있는 LocalScript에만 있습니다.

로컬 스크립트

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.selfieModeOpened:Connect(function()
print("Selfie mode open")
end)

셀카 모드 닫힘

플레이어가 셀카 모드를 닫거나 closeSelfieMode 가 호출될 때 화재가 발생합니다. 이 이벤트는 단독으로만 연결할 수 있습니다.

로컬 스크립트

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.selfieModeClosed:Connect(function()
print("Selfie mode closed")
end)

액션 활성화

매개 변수
액션: SelfieMode.Action활성화된 행동.

액션이 활성화되면 발생하며; 이는 필드 깊이 , 시선 잠금 또는 다른 사람 숨기기 와 같은 주요 작업 중 하나일 수 있습니다. 또는 대신 필터 또는 포즈 와 같은 하위 작업일 수 있습니다.연결된 함수는 활성화된 액션을 받습니다.이 이벤트는 LocalScript

로컬 스크립트

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.actionActivated:Connect(function(action)
print(action.name, "activated")
end)

액션 비활성화됨

매개 변수
액션: SelfieMode.Action비활성화된 액션.

주 작업 또는 하위 작업이 비활성화되면 발생합니다.연결된 함수는 비활성화된 액션을 받습니다.이 이벤트는 단독으로만 LocalScript에 연결할 수 있습니다.

로컬 스크립트

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.actionDeactivated:Connect(function(action)
print(action.name, "deactivated")
end)

필터 변경됨

매개 변수
새 필터: string새 필터.
오래된 필터: string이전 필터.

필터가 적용되거나 제거될 때 발생합니다.연결된 함수는 새 필터 이름과 이전 필터 이름을 받습니다.이 이벤트는 단독으로만 LocalScript에 연결할 수 있습니다.

로컬 스크립트

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.filterChanged:Connect(function(newFilter, oldFilter)
print("Filter changed from", oldFilter, "to", newFilter)
end)

포즈가 변경됨

매개 변수
새로운 포즈: string새로운 포즈.
오래된 포즈: string이전 포즈.

포즈가 적용되거나 제거될 때 발생합니다.연결된 함수는 새 포즈 이름과 이전 포즈 이름을 받습니다.이 이벤트는 단독으로만 LocalScript에 연결할 수 있습니다.

로컬 스크립트

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))
SelfieMode.poseChanged:Connect(function(newPose, oldPose)
print("Pose changed from", oldPose, "to", newPose)
end)