TV Providers
Last updated
Last updated
Your app can integrate with the TV app and single sign-on to offer people a highly convenient and consistent entertainment experience.
μ±μ μ¬λλ€μκ² λ§€μ° νΈλ¦¬νκ³ μΌκ΄λ μν°ν μΈλ¨ΌνΈ νκ²½μ μ 곡νκΈ° μν΄ TV app λ° single sign-onκ³Ό ν΅ν©ν μ μμ΅λλ€.
The TV app provides global access to favorite, recently played, and recommended movies and television shows from across the system.
TV μ±μ μμ€ν μ 체μμ μ’μνλ μ΅κ·Όμ μ¬μλκ±°λ μΆμ²λ μν λ° TV νλ‘κ·Έλ¨μ λν μ μ μ‘μΈμ€λ₯Ό μ 곡ν©λλ€.
The TV app automatically opens your app and sends it a notification when the user initiates content playback within your app.
TV μ±μ μ±μ μλμΌλ‘ μ΄κ³ μ¬μ©μκ° μ± λ΄μμ μ½ν μΈ μ¬μμ μμν λ μλ¦Όμ 보λ λλ€.
Ensure a smooth transition to your app. The TV app fades to black when transitioning to your app and doesnβt show your appβs launch screen. Your app should maintain visual continuity with this transition by immediately presenting its own black screen before starting to play or resume content.
μ±μΌλ‘ μνν μ νμ νμ€ν νμμμ€. TV μ±μ μ±μΌλ‘ μ ν ν λ κ²μ μμΌλ‘ ν¬λ―Έν΄μ§κ³ μ±μ μμ νλ©΄μ νμνμ§ μμ΅λλ€. μ±μμ μ½ν μΈ λ₯Ό μ¬μνκ±°λ λ€μ μμνκΈ° μ μ μ체 κ²μ μ νλ©΄μ μ¦μ νμνμ¬ μ΄λ¬ν μ νκ³Ό ν¨κ» μκ°μ μ°μμ±μ μ μ§ν΄μΌν©λλ€.
Show the expected content immediately. The user expects the chosen content to begin playing as soon as the transition to your app is complete. Jump right from your appβs black screen into content. Avoid presenting splash screens, detail screens, intro animations, or any other barriers that make it take longer to reach content. This is especially important when resuming playback.
μμ μ½ν μΈ λ₯Ό μ¦μ 보μ¬μ£Όμμμ€. μ¬μ©μλ μ±μΌλ‘μ μ νμ΄ μλ£λλ μ¦μ μ νν μ½ν μΈ κ° μ¬μλκΈ°λ₯Ό κΈ°λν©λλ€. μ±μ κ²μμ νλ©΄μμ λ°λ‘ μ½ν μΈ λ‘ μ΄λνμμμ€. μ€νλμ νλ©΄, μΈλΆ νλ©΄, μκ° μ λλ©μ΄μ λλ λ΄μ©μ λλ¬νλλ° μ€λ 걸릴 λ€λ₯Έ μ₯λ²½μ νΌνμμμ€. μ΄λ μ¬μμ λ€μ μμν λ νΉν μ€μν©λλ€.
Donβt ask whether the user wants to resume playback. If playback can be resumed, it should automatically do so without prompting for confirmation.
μ¬μ©μκ° μ¬μμ λ€μ μμν μ§ λ¬»μ§ λ§μμμ€. μ¬μμ λ€μ μμν μ μμΌλ©΄ νμΈμ μꡬνμ§ μκ³ μλμΌλ‘ μ¬μμ΄ μμλμ΄μΌ ν©λλ€.
Make sure content plays for the correct user. If your app supports multiple user profiles, the TV app can specify a profile when issuing a playback request. Your app should automatically switch to this profile before starting playback. If a playback request doesnβt specify a profile, ask the user to choose one before playback begins so this information can be provided in the future.
μ¬λ°λ₯Έ μ¬μ©μκ° μ½ν μΈ λ₯Ό μ¬μνλμ§ νμΈνμμμ€. μ±μ΄ μ¬λ¬ μ¬μ©μ νλ‘νμ μ§μνλ κ²½μ° TV μ±μ μ¬μ μμ²μ ν λ νλ‘νμ μ§μ ν μ μμ΅λλ€. μ¬μμ μμνκΈ° μ μ μ±μ΄ μλμΌλ‘ μ΄ νλ‘νλ‘ μ νλμ΄μΌν©λλ€. μ¬μ μμ²μμ νλ‘νμ μ§μ νμ§ μμΌλ©΄ μ¬μμ μμνκΈ° μ μ μ¬μ©μμκ² νλ‘νμ μ ννλλ‘ μμ²νμ¬ λμ€μ μ΄ μ 보λ₯Ό μ 곡 ν μ μμ΅λλ€.
If loading takes more than two seconds, consider showing a single, black loading screen with a centered activity spinner and no surrounding content.
λ‘λ©μ 2μ΄ μ΄μ 걸리λ κ²½μ°, μ€μμ μμΉν νλ μ€νΌλμ μ£Όλ³ μ½ν μΈ κ° μλ κ²μμμ λ¨μΌ λ‘λ νλ©΄μ 보μ¬μ£Όλ κ²μ κ³ λ €ν΄ λ³΄μμμ€.
Avoid loading screens whenever possible. A loading screen is unnecessary if your content loads quickly.
κ°λ₯ν ν λ‘λ© νλ©΄μ λ§μμμ€. 컨ν μΈ κ° λΉ¨λ¦¬ λ‘λλλ©΄ λ‘λ© νλ©΄μ΄ νμνμ§ μμ΅λλ€.
Start playback as soon as possible. If a loading screen is needed, it should be visible only until enough content has loaded for playback to begin. Continue loading remaining content in the background.
κ°λ₯ν ν 빨리 μ¬μμ μμνμμμ€. λ‘λ© νλ©΄μ΄ νμν κ²½μ°, μ¬μμ μμνκΈ°μ μΆ©λΆν μ½ν μΈ κ° λ‘λ λ λκΉμ§ νμλμ΄μΌν©λλ€. λ°±κ·ΈλΌμ΄λμμ λλ¨Έμ§ μ½ν μΈ λ₯Ό κ³μλ‘λνμμμ€.
Design black loading screens. Loading screens may appear during the transition to playing content. They should appear black so they blend with the fade-to-black functionality of the TV app.
κ²μ λ‘λ© νλ©΄μ λμμΈνμμμ€. 컨ν μΈ λ₯Ό μ¬μν λ λ‘λ© νλ©΄μ΄ λνλ μ μμ΅λλ€. κ·Έλ€μ κ²μμμΌλ‘ λνλμΌλ§ TV μ±μ fade-to-black κΈ°λ₯κ³Ό μμΌ κ²μ λλ€.
Minimize content on loading screens. If you must include branding or imagery on a loading screen, do so minimally and in a way that maintains the black background and moves seamlessly to playback.
λ‘λ© νλ©΄μμ 컨ν μΈ λ₯Ό μ΅μν νμμμ€. λ‘λ© νλ©΄μ λΈλλ© λλ μ΄λ―Έμ§λ₯Ό ν¬ν¨ν΄μΌνλ κ²½μ°, κ²μμ λ°°κ²½μ μ μ§νκ³ μ¬μμΌλ‘ μννκ² μ΄λνλ λ°©μμΌλ‘ μ΅μννμμμ€.
The user remains in your app after exiting playback, rather than returning to the TV app. This experience shouldnβt cause the user to become disoriented.
μ¬μ©μλ TV μ±μΌλ‘ λμκ°λ λμ μ¬μμ μ’ λ£ ν νμ μ±μ λ¨μ μμ΅λλ€. μ΄ κ²½νμΌλ‘ μΈν΄ μ¬μ©μλ λ°©ν₯ κ°κ°μ μμ§ μμμΌν©λλ€.
Show a contextually relevant screen. When exiting playback, display a detail screen for the content the user was just watching and include an option to resume playback. If a detail screen isnβt available, show a menu that includes the content the user was just watching or your appβs main menu.
λ¬Έλ§₯ μ μΌλ‘ κ΄λ ¨ νλ©΄μ 보μ¬μ£Όμμμ€. μ¬μμ μ’ λ£ ν λ μ¬μ©μκ° λ°©κΈ λ³΄κ³ μλ 컨ν μΈ μ λν μΈλΆ μ 보 νλ©΄μ νμνκ³ μ¬μμ λ€μ μμν μ μλ μ΅μ μ ν¬ν¨νμμμ€. μΈλΆ μ 보 νλ©΄μ μ¬μ©ν μ μλ κ²½μ° μ¬μ©μκ° λ°©κΈ λ³΄μλ μ½ν μΈ λ μ±μ κΈ°λ³Έ λ©λ΄κ° ν¬ν¨ λ λ©λ΄λ₯Ό νμν©λλ€.
Be prepared for an immediate exit. Prepare an exit screen as soon as possible after receiving a playback notification so the user sees it even if they exit immediately after playback begins.
μ¦μ μ’ λ£ ν μ€λΉλ₯Ό νμμμ€. μ¬μμ μμν μ¦μ μ’ λ£νμ¬λ μ¬μ©μκ° λ³Ό μ μλλ‘ μ¬μ μλ¦Όμ λ°μ νμ κ°λ₯ν ν 빨리 μ’ λ£ νλ©΄μ μ€λΉνμμμ€.
Many popular TV providers allow users to sign in to their accounts at the system level, eliminating the need to authenticate on an app-by-app basis. If your app requires TV provider authentication, use this capability to provide the most efficient onboarding experience.
λ§μ μ λͺ TV μ 곡 μ 체λ μ¬μ©μκ° μμ€ν μμ€μμ κ³μ μ λ‘κ·ΈμΈ ν μ μκ² νμ¬ μ±λ³λ‘ μΈμ¦ ν νμκ° μμ΅λλ€. μ±μ TV μ 곡 μ 체 μΈμ¦μ΄ νμν κ²½μ°μ΄ κΈ°λ₯μ μ¬μ©νμ¬ κ°μ₯ ν¨μ¨μ μΈ μ¨λ³΄λ© νκ²½μ μ 곡ν©λλ€.
Avoid displaying a sign-out option when the user is signed in at the system level. If your app must include a sign-out option, invoking it should direct the user to Settings > TV Provider to sign out of their account.
μ¬μ©μκ° μμ€ν μμ€μμ λ‘κ·ΈμΈ ν λ λ‘κ·Έμμ μ΅μ μ νμνμ§ λ§μμμ€. μ±μ λ‘κ·Έμμ μ΅μ μ΄ ν¬ν¨λμ΄μΌνλ κ²½μ° μ±μ νΈμΆνλ©΄ μ¬μ©μκ° μ€μ > TV νλ‘ λ°μ΄λλ‘ μ΄λνμ¬ κ³μ μμ λ‘κ·Έμμν΄μΌν©λλ€ .
Never instruct users to sign out by adjusting privacy controls. The TV provider controls in Settings > Privacy arenβt a sign out mechanism. These settings let users manage the apps that can access their TV provider account.
μ λ κ°μΈ μ 보 μ μ΄λ₯Ό μ‘°μ νμ¬ λ‘κ·Έμμ νλλ‘ μ¬μ©μμκ² μ§μνμ§ λ§μμμ€. μ€μ > κ°μΈ μ 보 보νΈμμ TV μ 곡 μ 체 컨νΈλ‘€μ λ‘κ·Έ μμ λ©μ»€λμ¦μ΄ μλλλ€. μ΄λ¬ν μ€μ μ μ¬μ©μκ° TV μ 곡 μ 체 κ³μ μ μ‘μΈμ€ ν μ μλ μ±μ κ΄λ¦¬ ν μ ββμκ² ν©λλ€.
TV Providers - System Capabilities - iOS - Human Interface Guidelines - Apple Developer