Xamarin에서 tvOS 진행률 표시기 사용Working with tvOS progress indicators in Xamarin

이 문서에서는 tvOS 앱 내에서 진행률 표시기를 디자인 하 고 사용 하는 방법을 설명 합니다.This article covers designing and working with progress indicators inside of a Xamarin.tvOS app.

TvOS 앱에서 새 콘텐츠를 로드 하거나 긴 처리 작업을 수행 해야 하는 경우가 있을 수 있습니다.There might be times when your Xamarin.tvOS app needs to load new content or perform a lengthy processing operation. 이러한 시간 동안에는 응용 프로그램이 여전히 실행 되 고 있음을 사용자에 게 알리는 작업 표시기 또는 진행률 표시줄을 표시 하 고 실행 중인 작업의 길이에 대 한 표시를 제공 해야 합니다.During these times, you should present either an activity indicator or a progress bar to let the user know that the app is still running and to give them some indication as to the length of the task being run.

샘플 진행률 표시기Sample progress indicators

활동 표시기 정보About activity indicators

활동 표시기는 회전 코그 표시 되 고 결정 되지 않은 길이의 작업을 나타내는 데 사용 됩니다.An activity indicator presents as a spinning cog and is used to represent a task of an undetermined length. 작업을 시작 하 고 작업이 완료 되 면 사라질 때 표시기가 표시 됩니다.The indicator is presented when the task starts and disappears when the task is completed.

Apple에는 활동 표시기를 사용 하기 위한 다음과 같은 제안이 있습니다.Apple has the following suggestions for working with activity indicators:

  • 가능 하면 항상 진행률 표시줄을 사용 합니다. 작업 표시기는 실행 중인 프로세스에 걸리는 시간에 대 한 피드백을 사용자에 게 제공 하지 않으므로 항상 길이를 알 수 있는 경우 (예: 파일에서 다운로드할 바이트 수) 항상 진행률 표시줄을 사용 합니다.Whenever possible, use progress bars instead - Because an activity indicator gives the user no feedback as to how long the process being run will take, always use a progress bar if the length is known (for example, how many bytes to download in a file).
  • 표시기를 애니메이션으로 유지 -사용자가 고정 된 작업 표시기를 지연 된 앱에 연결 하므로 표시 되는 동안 항상 표시기에 애니메이션 효과를 적용 해야 합니다.Keep the indicator animated - Users relate a stationary activity indicator to a stalled app, so you should always animate the indicator while it is being displayed.
  • 처리 중인 작업에 대해 설명 합니다. 작업 표시기를 단독으로 표시 하는 것 만으로는 충분 하지 않습니다. 사용자는 대기 중인 프로세스에 대해 알고 있어야 합니다.Describe the task being processed - Just displaying the activity indicator by itself isn't enough; the user needs to be informed about the process on which they are waiting. 작업을 명확 하 게 정의 하는 의미 있는 레이블 (일반적으로 단일 전체 문장)을 포함 합니다.Include a meaningful label (usually a single, complete sentence) that clearly defines the task.

진행률 표시줄 정보About progress bars

진행률 표시줄은 시간이 많이 걸리는 작업의 상태 및 길이를 나타내기 위해 색으로 채워진 선으로 나타납니다.A progress bar presents as a line that fills with color to indicate the state and length of a time-consuming task. 작업의 길이를 알 수 있거나 계산할 수 있는 경우에는 항상 진행률 표시줄을 사용 해야 합니다.Progress bars should always be used when the length of the tasks is known or can be computed.

Apple에는 진행률 표시줄을 사용 하기 위한 다음과 같은 제안이 있습니다.Apple has the following suggestions for working with progress bars:

  • 정확히 보고 진행률 -진행률 표시줄은 작업을 완료 하는 데 필요한 시간을 정확 하 게 표시 해야 합니다.Accurately report progress - Progress bars should always present an accurate representation of the time required to complete a task. 앱을 사용 중으로 표시 하는 시간을 조작할 수 없습니다.Never misrepresent the time to make the app appear busy.
  • 잘 정의 된 기간에 사용 -진행률 표시줄은 시간이 오래 걸리는 작업을 표시 하는 것 뿐만 아니라 완료 된 작업의 양과 남은 시간을 보여 줍니다.Use for well-defined durations - Progress bars should not only show that a lengthy task is taking place, but give the user and indication of how much of the task is completed and an estimate of the time remaining.

진행률 표시기 및 storyboardProgress indicators and storyboards

TvOS 앱에서 진행률 표시기를 사용 하는 가장 쉬운 방법은 iOS Designer를 사용 하 여 앱의 UI에 추가 하는 것입니다.The easiest way to work with a progress indicator in a Xamarin.tvOS app is to add it to the app's UI using the iOS Designer.

  1. Solution Pad에서 주 storyboard 파일을 두 번 클릭 하 여 편집용으로 엽니다.In the Solution Pad, double-click the Main.storyboard file and open it for editing.

  2. 도구 상자 에서 활동 표시기 를 끌어서 뷰에 놓습니다.Drag an Activity Indicator from the Toolbox and drop it on the view:

    활동 표시기An activity indicator

  3. Properties Pad위젯 탭에서 작업 표시기의 스타일, 동작이름과같은 몇 가지 속성을 조정할 수 있습니다.In the Widget tab of the Properties Pad, you can adjust several properties of the activity indicator such as its Style, Behavior, and Name:

    활동 표시기의 위젯 탭The Widget tab for an activity indicator

    이름 은 코드의 C# 작업 표시기를 나타내는 속성의 이름을 결정 합니다.The Name determines the name of the property that represents the activity indicator in C# code.

  4. 도구 상자 에서 진행률 보기 를 끌어서 뷰에 놓습니다.Drag a Progress View from the Toolbox and drop it on the view:

    진행률 보기A progress view

  5. 속성 탐색기위젯 탭에서 진행률 보기의 스타일, 진행률 (완료율), 이름등의 몇 가지 속성을 조정할 수 있습니다.In the Widget tab of the Property Explorer, you can adjust several properties of the progress view such as its Style, Progress (percent complete), and Name:

    진행률 보기의 위젯 탭The Widget tab for a progress view

    이름 은 코드에서 C# 진행률 뷰를 나타내는 속성의 이름을 결정 합니다.The Name determines the name of the property that represents the progress view in C# code.

  6. 변경 내용을 저장합니다.Save your changes.

스토리 보드 사용에 대 한 자세한 내용은 Hello, tvOS 빠른 시작 가이드를 참조 하세요.For more information on working with storyboards, please see our Hello, tvOS Quick Start Guide.

활동 표시기 작업Working with activity indicators

위에서 설명한 것 처럼 앱이 길이가 정해 지지 않은 긴 프로세스를 실행 하는 경우 활동 표시기가 표시 되어야 합니다.As stated above, activity indicators should be shown when your app is running a long process of indeterminate length.

언제 든 지 IsAnimating 속성을 확인 하 여 활동 표시기가 애니메이션 효과를 주는 지 확인할 수 있습니다.At any point, you can see if an activity indicator is animating by checking its IsAnimating property. HidesWhenStopped 속성이 true이면 애니메이션이 중지 될 때 작업 표시기가 자동으로 숨겨집니다.If the HidesWhenStopped property is true, the activity indicator will automatically be hidden when its animation is stopped.

애니메이션을 시작 하려면 다음 코드를 사용할 수 있습니다.You can use the following code to start the animation:

ActivityIndicator.StartAnimating();

그리고 다음을 수행 하면 애니메이션이 중지 됩니다.And the following will stop the animation:

ActivityIndicator.StopAnimating();

참고

이러한 코드 조각은 iOS 디자이너의 위젯 탭에서 활동 표시기의 이름이 activityindicator 로 설정 된 것으로 가정 합니다.These code snippets assume that the activity indicator's Name was set to ActivityIndicator in the Widget tab of the iOS Designer.

진행률 표시줄 작업Working with progress bars

앱이 알려진 기간의 장기 실행 작업을 실행할 때 언제 든 지 진행률 표시줄을 사용 해야 합니다.Again, a progress bar should be used any time your app is executing a long running task of a known duration.

Progress 속성은 완료 된 작업의 양을 0%에서 100% (0.0에서 1.0)로 설정 하는 데 사용 됩니다.The Progress property is used to set the amount of the task that has been completed from 0% to 100% (0.0 to 1.0). ProgressTintColor 속성을 사용 하 여 완료 된 막대의 색을 설정 하 고 TrackTintColor 속성을 사용 하 여 배경색을 설정 합니다 (완료 되지 않은 금액).Use the ProgressTintColor property to set the color of the amount completed bar and the TrackTintColor property to set the background color (uncompleted amount).

요약Summary

이 문서에서는 tvOS 앱 내에서 진행률 표시기를 디자인 하 고 작업 하는 방법에 대해 설명 했습니다.This article has covered designing and working with progress indicators inside of a Xamarin.tvOS app.