Studio ManualAPI ReferenceVideo TutorialSample

Media

Media

클라이언트에서 사용되는 Media 개체에요.

이벤트

OnUploadRequested

file upload 시 event입니다. 연결함수 형식은 function() 입니다.

OnUploadFailed

file upload 실패 시 event입니다. 연결함수 형식은 function() 입니다.

OnLoadCompleted

file Load 완료 시 event입니다. 연결함수 형식은 function() 입니다.

OnUploadProgress

file Upload 진행 시 event입니다. 연결함수 형식은 function(progress), progress 는 0 ~ 1 사이의 진행정도값 입니다.

OnErrorMessage

error event입니다. 연결함수 형식은 function(error Index), error Index는 error 종류 입니다. 반환값 0 (알수 없는 에러), 1(파일 포멧이 다름), 2(사용 불가 이름)

OnEndReached

file Upload 진행 시 event입니다. 연결함수 형식은 function() 입니다.

속성

GetMediaKey

(deprecated) OpenFileDialog로 오픈한 파일이 저장된 URL 이에요.

YouTubeURL

MediaURL를 얻을 수 있어요. (deprecated) MediaURL 를 사용하세요.

MediaURL

MediaURL를 얻을 수 있어요.

-- 샘플 --

local Media = Workspace.Media

Media.MediaURL = "https://www.youtube.com/watch?v=jP1x7DVxTP4"
Media:OpenURL()
Media:Play()

Looping

Looping를 얻을 수 있어요.

-- 샘플 --

local Media = Workspace.Media

Media.Looping = false

PlayOnOpen

-- 샘플 --

local Media = Workspace.Media

Media.PlayOnOpen = true

SoundInnerRadius

Sound의 소리 반경을 얻을 수 있어요. (Sound의 전체 반경은 SoundInnerRadius + SoundFalloffDistance)

-- 샘플 --

local Media = Workspace.Media

Media.SoundInnerRadius = 200

SoundFalloffDistance

Sound의 감쇠 반경을 얻을 수 있어요. (Sound의 전체 반경은 SoundInnerRadius + SoundFalloffDistance)

-- 샘플 --

local Media = Workspace.Media

Media.SoundFalloffDistance = 1000

TriggerPlay

-- 샘플 --

local Media = Workspace.Media

Media.TriggerPlay = true

AutoPlay

ShapeLocation

AutoPlay 영역 위치 이동.

-- 샘플 --

local Media = Workspace.Media

Media.ShapeLocation  = Vector.new(0, 0, 0)

AutoPlayOffset

AutoPlay 영역 위치 이동. (deprecated) ShapeLocation를 사용하세요.

TriggerShapeType

MediaTriggerShapeType 자동 플레이 영역 타입 Sphere, Cube

-- 샘플 --

local Media = Workspace.Media

Media.TriggerShapeType  = Enum.MediaTriggerShapeType.Sphere

AutoPlayType

MediaTriggerShapeType 자동 플레이 영역 타입 Sphere, Cube (deprecated) TriggerShapeType를 사용하세요.

PlayRadius

Play Sphere 타입 반경을 얻을 수 있어요. (전체 반경은 PlayRadius + PauseRadius)

-- 샘플 --

local Media = Workspace.Media

Media.PlayRadius = 1000

PauseRadius

Pause Sphere 타입 반경을 얻을 수 있어요. (전체 반경은 PlayRadius + PauseRadius)

-- 샘플 --

local Media = Workspace.Media

Media.PauseRadius = 1000

PlayCubeSize

Trigger Play Cube 타입 Play 사이즈를 얻을 수 있어요. (전체 사이즈는 PlayCubeSize + PauseCubeOffset)

-- 샘플 --

local Media = Workspace.Media

Media.PlayCubeSize = Vector.new(500, 200, 200)

AutoPlaySize

Trigger Play Cube 타입 Play 사이즈를 얻을 수 있어요. (전체 사이즈는 PlayCubeSize + PauseCubeOffset) (deprecated) PlayCubeSize를 사용하세요.

PauseCubeOffset

Trigger Play Cube 타입 Pause 사이즈를 얻을 수 있어요. (전체 사이즈는 PlayCubeSize + PauseCubeOffset)

-- 샘플 --

local Media = Workspace.Media

Media.PauseCubeOffset = 200

PauseOffset

Trigger Play Cube 타입 Pause 사이즈를 얻을 수 있어요. (전체 사이즈는 PlayCubeSize + PauseCubeOffset) (deprecated) PauseCubeOffset를 사용하세요.

Is3DSound

Is3DSound 3d 사운드 재생시 true, 2d 사운드 재생 false (deprecated) Sound3D 를 사용하세요.

Sound3D

Sound3D 3d 사운드 재생시 true, 2d 사운드 재생 false

-- 샘플 --

local Media = Workspace.Media

Media.Sound3D  = true

함수

void OpenURL()

Media 주소로 연결해요.

-- 샘플 --

local Media = Workspace.Media

Media.MediaURL = "https://www.youtube.com/watch?v=jP1x7DVxTP4"
Media:OpenURL()
Media:Play()

void SetMediaState(MediaState Type)

현재 Media의 상태를 바꿔요. (Play, Pause)

-- 샘플 --

local Media = Workspace.Media

Media.MediaURL = "https://www.youtube.com/watch?v=jP1x7DVxTP4"
Media:OpenURL()
Media:SetMediaState(Enum.MediaStateType.Play)

MediaState GetMediaState()

Media의 상태를 판별할 수 있어요.

-- 샘플 --

local Media = Workspace.Media

wait(5)

if Media:GetMediaState() == Enum.MediaStateType.Play then
    print("DoSomething!")
end

void Play()

Media를 플레이시켜요.

-- 샘플 --

local Media = Workspace.Media

Media.MediaURL = "https://www.youtube.com/watch?v=jP1x7DVxTP4"
Media:OpenURL()
Media:Play()

bool IsPlaying()

Media가 플레이 중인지 판별할 수 있어요.

-- 샘플 --

local Media = Workspace.Media

wait(5)

if Media:IsPlaying() then
    print("DoSomething!")
end

void Pause()

Media를 일시 중지 시켜요.

-- 샘플 --

local Media = Workspace.Media

wait(2)
Media:Pause() --Pause
wait(2)
Media:Pause() --Resume

bool IsPaused()

Media가 일시 중지 중인지 판별할 수 있어요.

-- 샘플 --

local Media = Workspace.Media

wait(5)

if Media:IsPaused() then
    print("DoSomething!")
end

void Close()

Media를 꺼요.

-- 샘플 --

local Media = Workspace.Media

wait(1)
Media:Close()

bool IsClosed()

Media가 꺼져있는지 판별할 수 있어요.

-- 샘플 --

local Media = Workspace.Media

wait(5)

if Media:IsClosed() then
    print("DoSomething!")
end

bool IsPreparing()

Media가 준비 중인지 판별할 수 있어요.

-- 샘플 --

local Media = Workspace.Media

wait(5)

if Media:IsPreparing() then
    print("DoSomething!")
end

bool IsReady()

Media가 준비되었는지 판별할 수 있어요.

-- 샘플 --

local Media = Workspace.Media

wait(5)

if Media:IsReady() then
    print("DoSomething!")
end

bool IsWaitingForResponse()

"Stream URL 얻기"에 대해 응답 대기 중인지 판별할 수 있어요.

-- 샘플 --

local Media = Workspace.Media

wait(5)

if Media:IsWaitingForResponse() then
    print("DoSomething!")
end

bool IsPlaySync()

IsPlaySync 상태 인지 판별할 수 있어요. (deprecated) IsSyncWithPlayers 를 사용하세요.

bool IsSyncWithPlayers()

IsSyncWithPlayers 상태 인지 판별할 수 있어요.

-- 샘플 --

local Media = Workspace.Media

wait(5)

if Media:IsSyncWithPlayers() then
    print("DoSomething!")
end

void OpenFileDialog()

파일을 선택할 수 있게 다이얼로그 창으로 연결해요. (AutoPlay)

string OpenMediaURL(string MediaURL)

(deprecated) 가져온 MediaURL로 Play할 수 있어요.

사용 가능한 부모 오브젝트 기능들

속성

이름

설명

Enable

객체 활성화 여부

Transform

객체의 Matrix

LocalTransform

객체의 Local Transform

Location

객체의 위치 Vector

LocalLocation

객체의 로컬좌표 Vector

Rotation

객체의 회전 Vector

LocalRotation

객체의 로컬 회전 Vector

Scale

객체의 크기 Vector

Visible

객체의 가시성

이벤트

이름

설명

OnUpdateEvent

생성 후 매 프레임마다 호출되는 이벤트에요. 연결함수 형식은 function(updateTime), updateTime 은 number 입니다.

OnDestroyEvent

삭제될 때 호출되는 이벤트에요. 연결함수 형식은 function() 입니다.

OnEnableEvent

Enable 될때 호출되는 이벤트에요. 연결함수 형식은 function() 입니다.

OnDisableEvent

Disable 될때 호출되는 이벤트에요. 연결함수 형식은 function() 입니다.

함수

이름

설명

GetKey

객체의 키 값을 얻을 수 있어요.

SetTransformWithCollisionCheck

현재 매트릭스에서 설정 된 매트릭스로 보간이 되는 매트릭스를 설정할 수 있어요 설정할 수 있어요. (Matrix 값, bool 충돌 처리 여부)

SetLocalTransformWithCollisionCheck

현재 매트릭스에서 설정 된 매트릭스로 보간이 되는 매트릭스를 로컬좌표기준으로 설정할 수 있어요 설정할 수 있어요. (Matrix 값, bool 충돌 처리 여부)

Teleport

순간이동 하는 매트릭스를 설정할 수 있어요. (Matrix 값)

SetLocationWithCollisionCheck

객체의 위치를 설정할 수 있어요. (설정할 위치 Vector 값, 충돌 처리 여부)

SetTag

객체의 tag를 설정해요. (설정할 tag)

GetTag

객체에 설정된 tag를 얻을 수 있어요.

ConnectEventFunction

유저가 추가한 오브젝트 커스텀 이벤트에 함수를 연결할 수 있어요. (이벤트 이름, 연결 함수)

LookAt

오브젝트가 해당하는 위치를 바라보게 할 수 있어요. (바라볼 위치 Vector)

PreviousLocalPlayerNextMediaView

Last updated

Was this helpful?