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)