You can use VideoFrame to play video assets in your game, either on a SurfaceGui in the 3D world or on a ScreenGui interface. Because every video asset must be downloaded to each player's device before it can play, the way your game preloads and plays video has a direct impact on data usage and performance. Monitoring how often video is downloaded versus actually viewed helps you reduce unnecessary data transfer and deliver a smoother experience, especially on lower-end devices.
관찰 가능성
The Video Service dashboard provides insights and analytics for monitoring and optimizing how your game downloads and plays video assets. You can find it in the Monitoring section of the Creator Dashboard. The dashboard features two primary charts: Playback breakdown, which shows the proportion of efficient versus inefficient video usage, and Playback hours, which tracks total video playback hours over the selected period so you can see how new videos, updates, and changes to your playback logic affect usage over time.
You can scope both charts using the following filters:
| 필터 | 설명 |
|---|---|
| 날짜 범위 | 표시된 데이터의 시간 창, 예: 지난 28일. |
| 장소 | 분석할 게임 내 특정 장소. |
| 시간 간격 | 데이터 포인트의 세부 수준, 예: 일 단위. |
비디오 사용 카테고리
Both charts categorize video usage into the following dimensions. Efficient usage is video that is preloaded, played, and actually viewed by your players.
| 상태 | 설명 |
|---|---|
| 재생됨, 시청됨 | 재생되었고 실제로 당신의 플레이어가 시청한 비디오. 이는 효율적인 비디오 사용을 나타냅니다. |
| 미리 로드됨, 재생되지 않음 | 다운로드된 비디오(Video 또는 VideoContent 속성이 설정됨)지만 재생되지 않은 비디오. 이 데이터는 불필요하게 다운로드되었습니다. |
| 재생됨, 시청되지 않음 | 재생되었지만 실제로 플레이어가 시청하지 않은 비디오, 예를 들어 어떤 플레이어도 근처에 없거나 관련 UI가 표시되지 않았기 때문입니다. 이 재생은 여전히 데이터와 메모리를 소모했지만 플레이어에게는 아무 이익을 주지 않았습니다. 비디오의 오디오만 재생하기 위해 비디오를 디코딩하는 경우, 시각적 콘텐츠가 표시되지 않기 때문에 시청된 것으로 간주되지 않습니다. 오디오만 필요하다면 비디오 자산 대신 오디오 자산으로 추출하여 재생하는 것이 더 효율적이며 불필요한 데이터와 메모리 사용을 줄일 수 있습니다. |
비디오 효율성 향상
To improve video efficiency, only set the Video or VideoContent property and call VideoFrame:Play() when a player has a high chance of seeing or hearing the VideoFrame, and clear the property (for example, set it to "") once the video is no longer visible or playing and no players are nearby.
미리 로드하고 비디오 콘텐츠를 미리 설정하는 것은 비디오가 보이거나 들릴 것이라고 확신할 때 여전히 권장됩니다. 예를 들어 게임의 이후에 필수 컷신이 있거나 중앙 지역과 같이 영상이 표시되는 경우에 해당합니다. 이러한 경우, 미리 로드는 플레이어가 도달했을 때 로딩 지연 없이 비디오가 매끄럽게 재생되도록 돕습니다.