Video

The system-provided video player offers two viewing modes: full-screen (aspect fill) and fit-to-screen (aspect). By default, the system selects a viewing mode based on a video's aspect ratio, and the user can switch modes during playback. For developer guidance, see AVPlayerViewController.

시스템 제공 비디오 플레이어는 full-screen (가로 채우기)과 fit-to-screen (세로)의 두 가지 보기 모드를 제공합니다. 기본적으로 시스템은 비디오의 종횡비에 따라보기 모드를 선택하며 사용자는 재생 중에 모드를 전환 할 수 있습니다.

  • Full-screen (aspect-fill) viewing mode. The video scales to fill the display. Some edge cropping may occur. This is the default viewing mode for wide video (2:1 through 2.40:1). For developer guidance, see resizeAspectFill.

비디오가 화면에 맞게 확장됩니다. 일부 가장자리가 잘릴 수 있습니다. 이 모드는 와이드 비디오의 기본 보기 모드입니다(2:1 ~ 2.40:1).

  • Fit-to-screen (aspect) viewing mode. The entire video is visible onscreen. Letterboxing or pillarboxing will occur. This is the default viewing mode for standard video (4:3, 16:9, and anything up to 2:1) and ultra-wide video (anything above 2.40:1). For developer guidance, see resizeAspect.

전체 비디오가 화면에 표시됩니다. Letterboxing 또는 Pilotboxing이 수행됩니다. 표준 비디오(4:3, 16:9 및 최대 2:1) 및 초광대 비디오의 기본 보기 모드입니다(2.40:1 이상).

Examples of Viewing Modes on iPhone XS

Make sure custom video players behave as expected. The objective is to fill the display by default when playing video content on full-screen devices. However, if filling the display results in too much cropping, the video should be scaled to fit the screen. You should also allow people to switch between full-screen and fit-to-screen viewing based on their individual preferences. For developer guidance, see AVPlayerLayer.

사용자 정의 비디오 플레이어가 예상대로 작동하는지 확인하십시오. 목표는 전체 화면 장치에서 비디오 콘텐츠를 재생할 때 기본적으로 디스플레이를 채우는 것입니다. 그러나 화면을 채운 결과로 너무 많이 잘리면 화면에 맞게 비디오의 크기를 조정해야합니다. 또한 사람들이 개별 선호도에 따라 full-screen과 fit-to-screen을 전환 할 수 있도록해야합니다.

Examples of Padding on iPhone XS

Always display video content at its original aspect ratio. When video content uses embedded letterbox or pillarbox padding to conform to a specific aspect ratio, iOS is unable to correctly scale the video based on the user's choice of viewing modes. Padding embedded within the video frame can cause videos to appear smaller in full-screen mode and fit-to-screen mode. It also prevents videos from displaying correctly in edge-to-edge, non-full-screen contexts, like Picture in Picture mode on iPad.

항상 원래의 가로 세로 비율로 비디오 콘텐츠를 표시합니다. 비디오 콘텐츠가 특정 가로 세로 비율을 따르는 내장된 letterbox 또는 pillarbox 를 사용하는 경우, iOS는 사용자가 선택한 보기 모드를 기준으로 비디오의 크기를 올바르게 조정할 수 없습니다. 비디오 프레임에 포함된 패딩으로 인해 full-screen및 fit-to-screen 모드에서 비디오가 더 작게 나타날 수 있습니다. 또한 iPad의 Picture in Picture 모드와 같은 edge-to-edge, non-full-screen에서 비디오가 올바르게 표시되지 않도록 합니다.

Video - Visual Design - iOS - Human Interface Guidelines - Apple Developer

Last updated