셀카 모드 | 설명서 - Roblox 크리에이터 허브

플레이어는 이미 스크린 샷을 가져 플레이어가 체험에서 즐거운 순간을 기념하기 위해. 셀카 모드개발자 모듈 플레이어가 채팅 창이나 플레이어 목록 없이 그 순간을 더 클리어하게 캡처하도록 하면서 필터 효과, 다른 캐릭터의 숨기기 및 포�

모듈 사용

설치

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

从 보기 탭에서 도구 상자를 엽니다. 그리고 크리에이터 스토어 탭을 선택합니다.
모델 정렬을 선택한 다음 모두 보기 버튼을 클릭하여 범주 에 대한 전체 보기를 클릭하십시오.
찾아 클릭하십시오 개발자 모듈 타일.
셀카 모드 모듈을 찾아 클릭하거나 3D 뷰에 드래그 앤 드롭하세요.
In the 탐색기 창에서 전체 SelfieMode 모델을 ServerScriptService 로 이동합니다. 경험을 실행할 때 모듈은 다양한 서비스에 배포되고 실행을 시작합니다.

구성

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

In StarterPlayerScripts , create a new LocalScript and rename it to ConfigureSelfieMode .

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

로컬 스크립트 - 셀카 모드 구성
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

SelfieMode.configure({
	disableCharacterMovement = true
})

캐릭터 이동

셀카 모드에서 플레이어의 캐릭터가 이동하지 않도록 하는 것이 좋습니다. 이를 달성하려면 disableCharacterMovement를 구성 요청에 설정하십시오.

로컬 스크립트 - 셀카 모드 구성
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

SelfieMode.configure({
	disableCharacterMovement = true
})

셀카 모드 액션

셀카모드 는 다음과 같은 작업을 포함하여, 각 작업을 활성화작업, 0>비활성화작업0> 및 토글작업을 사용하여 사용할 수 있습니다. 또는 이벤트 활성화를 감지하여 이벤트 비활성화 및 토글 작업을

필드 깊이

기본적으로, 셀카 모드는 플레이어가 액션을 전환할 때 표준적인 Depth of Field 효과(배경의 미세한 흐림)를 표시합니다.

이 효과는 휴대 장치, 예를 들어 전화 및 태블릿에서는 렌더링되지 않습니다. 따라서 이 장치에서는 이 효과를 액션으로 제공하지 않습니다.

모바일 장치에서 플레이어의 그래픽 품질( 설정 →그

기본 DepthOfField 효과를 변경하려면 depthOfFieldEffect를 자신의 DepthOfFieldEffect 인스턴스에 설정하십시오. Configure 콜백에서.

로컬 스크립트 - 셀카 모드 구성
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
})

시선 잠금

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

다른 사람 숨기기

기본적으로 다른 캐릭터는 플레이어의 캐릭터 옆에 표시됩니다. 플레이어는 다른 사람 숨기기 버튼을 클릭하여 완벽한 솔로 샷을 얻을 수 있습니다. 토글이 켜진 상태에서 다른 캐릭터는 보이지 않고 작업이 종료될 때까지 보이지 않습니다.

필터

필터 작업은 필터 작업을 사용하여 플레이어가 옵션 Pop, Soft, 2>Antique2>, 5>Cute5>, 8>Dramatic8>, 및 1>Monochrome 1>에 대한 사전 필터를 적용할 수 있습니다.

포즈

포즈 액션은 플레이어가 옵션 응원, 클래핑, 돌고래, 2>갈퀴2>, 5>기타5>, 8>점프 웨이브

API 참조

형식

액션

각 작업은 다음 키 값 쌍으로 사전에 표시됩니다:

키	유형	설명
name	문자열	도구 모음에 표시되는 액션이름.
description	문자열	도구 모음에 있는 이름 후에 작업 설명이 표시됩니다.
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)

열거

셀카모드.액션

셀카모드 는 여러 작업 을 포함합니다. 이 열거는 작업 활성화, 0>작업 비활성화0> 및 3>토글 작업 3> 기능과 함께 사용할 수 있습니다.

이름	요약
DepthOfField	Depth of Field 액션대한 참조.
LockGaze	참조: 시선 잠금 액션.
HideOthers	다른 사람 숨기기 액션대한 참조.
Filter	필터 액션대한 참조.
Pose	포즈 액션대한 참조.

로컬 스크립트
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

-- 필터 작동 액션
SelfieMode.activateAction(SelfieMode.Action.Filter)

함수

구성

구성(구성: table )

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

키	설명	기본
disableCharacterMovement	예, 셀카 모드가 열려 있는 동안 캐릭터가 이동하지 않도록 합니다.	없음
depthOfFieldEffect	플레이어가 DepthOfFieldEffect 액션을 전환할 때 나타나는 선택적 인 커스텀 Class.DepthOfFieldEffect 인스턴스.

로컬 스크립트 - 셀카 모드 구성
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

SelfieMode.configure({
	disableCharacterMovement = true
})

셀카 모드 열기

openSelfieMode()

플레이어는 일반적으로 화면 오른쪽의 "카메라" 버튼으로 셀카 모드를 엽니다. 그러나 이 기능을 사용하면 코드로 열 수 있습니다. 아래에 표시된 사용자 지정 버튼을 통해 기본 버튼을 비활성화할 수 있습니다. 이 기능은 Class.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)

셀카모드 닫기

닫기SelfieMode()

플레이어는 일반적으로 화면 하단의 ⊗ 버튼으로 셀카 모드를 닫지만, 이 기능을 사용하면 코드로 닫을 수 있습니다. LocalScript에서만 호출할 수 있습니다.

로컬 스크립트
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

SelfieMode.closeSelfieMode()

자동 얼굴 인식 모드가 열려 있습니까?

isSelfieModeOpen() : boolean

true 이 경우 플레이어 작업 또는 openSelfieMode 를 통해 셀카 모드가 열려 있으면 반환합니다. 이 함수는 LocalScript 에서만 호출할 수 있습니다.

로컬 스크립트
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

SelfieMode.openSelfieMode()

print(SelfieMode.isSelfieModeOpen())

설정HudButtonEnabled

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): 액션

SelfieMode.Action 열거형을 통해 액션 유형을 얻습니다.

로컬 스크립트
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

local lockGazeAction = SelfieMode.getAction(SelfieMode.Action.LockGaze)

액션 활성화

액션 활성화(액션: SelfieMode.Action )

기본 액션 중 하나를 프로그래밍 방식으로 활성화합니다. 이는 플레이어가 액션 바에서 액션을 전환할 때와 동일합니다. LocalScript 에서만 호출할 수 있습니다.

로컬 스크립트
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

-- 필터 작동 액션
SelfieMode.activateAction(SelfieMode.Action.Filter)

동작 비활성화

deactivateAction(액션: SelfieMode.Action )

기본 액션 중 하나를 프로그래밍으로 비활성화합니다. 이것은 플레이어가 액션 바에서 액션을 끄면과 동일합니다. LocalScript 에서만 호출할 수 있습니다.

로컬 스크립트
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

-- 필터 작동 액션
SelfieMode.deactivateAction(SelfieMode.Action.Filter)

액션 전환

액션(액션: SelfieMode.Action): boolean

액션이 끄기액션 을 토글하거나 켜면 끄거나. 이것은 플레이어가 액션 바에서 액션을 클릭할 때와 같습니다. 새로운 "is 토글 되었습니다" 상태를 부울로 반환합니다. 콜 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

테마 설정

테마 설정(테마: table )

텍스트 크기, 서체, 버튼/튜토리얼 색상 등을 포함한 셀카 모드 테마를 구성합니다. 이 함수는 LocalScript에서만 호출할 수 있습니다.

키	설명	기본
textSize	모든 텍스트의 크기.	16
font	모든 UI에 사용된 글꼴(Enum.Font).	GothamMedium
padding	UI 요소를 배치하는 데 사용되는 주 패딩(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)

이벤트

셀카모드 열림

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

로컬 스크립트
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

SelfieMode.selfieModeOpened:Connect(function()
	print("Selfie mode open")
end)

셀카모드 닫힘

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

로컬 스크립트
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))

SelfieMode.selfieModeClosed:Connect(function()
	print("Selfie mode closed")
end)

활동 활성화

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

액션이 활성화되면 발생합니다; 이것은 Depth of Field, Lock Gaze 또는 Hide Others 와 같은 주요 액션 중 하나일 수 있습니다; 또는 2>Filter2> 또는 5>포��

로컬 스크립트
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	새로운 필터.
oldFilter: string	이전 필터.

필터를 적용하거나 제거하면 발생합니다. 연결된 함수는 새 필터 이름과 이전 필터 이름을 받습니다. 이 이벤트는 Class.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	새로운 포즈.
oldPose: 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)