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?