TvOS Xamarin에서 진행률 표시기 작업Working with tvOS progress indicators in Xamarin

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

Xamarin.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.

진행률 표시기 및 스토리 보드Progress indicators and storyboards

Xamarin.tvOS 앱에서 진행률 표시기를 사용 하는 가장 쉬운 방법은 iOS 디자이너를 사용 하 여 앱의 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를 두 번 클릭 합니다 Main.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.

스토리 보드를 사용 하 여 작업에 대 한 자세한 내용은 참조 하십시오 우리의 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();

참고

이러한 코드 조각은 가정 활동 표시기 이름을 로 설정 된 ActivityIndicator위젯 iOS 디자이너의 탭 합니다.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

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