Simplify sign in for your tvOS apps

ハイライト

tvOS 15 は、AuthenticationServices を介したシステムログインビューを提供し、ユーザーが iPhone または iPad で iCloud キーチェーン、Face ID、または Touch ID を使用して Apple TV アプリのログインと購入認証を完了できるようにします。

主要内容

Apple TV にサインインするのはいつも面倒でした。

メディアアプリでは、多くの場合、ユーザーが電子メールとパスワードを入力する必要があります。ユーザーはセキュリティ上の理由から、長くてランダムなパスワードを使用します。テレビのリモコンでこのパスワードを入力するのは好ましくありません。ユーザーはコンテンツを表示する前にログインページでスタックします。

tvOS 15 の機能は、Apple TV と iPhone または iPad の間でログインプロセスを分割することです。ユーザーはクリックして Apple TV アプリにログインし、iPhone を手に取ると Apple TV からの通知が表示されます。通知をクリックすると、iPhone は iCloud キーチェーンの認証情報を推奨し、Face ID または Touch ID で確認します。確認後、認証情報が Apple TV に返され、アプリは引き続き独自のサーバーへのログインを完了します。

このプロセスでは、システムログインビューが使用されます。ログインポータルを tvOS に統合し、ユーザーに iPhone または iPad の使用を継続するように指示します。アプリの場合、コアコードはまだ AuthenticationServices フレームワーク内にありますASAuthorizationController。

ログインページには他の入り口も保持できます。たとえば、手動でログインし、TV サービスプロバイダーのアカウントを使用し、アプリ内購入を復元します。開発者パスcustomAuthorizationMethodsどの追加ボタンを表示するかをシステムに指示します。ユーザーがそれを選択すると、アプリは対応するカスタマイズプロセスに入ります。

詳細

パスワード認証情報を要求する

(03:28) ログインボタンをクリックすると、アプリは認証コントローラーを作成し、パスワード要求を渡します。ここで使われているASAuthorizationPasswordProvider。

import AuthenticationServices

final class SignInViewController: UIViewController, ASAuthorizationControllerDelegate {
    func beginSignIn() {
        let controller = ASAuthorizationController(authorizationRequests: [
            ASAuthorizationPasswordProvider().createRequest()
        ])

        controller.delegate = self
        controller.performRequests()
    }
}

キーポイント:

行 1: AuthenticationServices (認証サービス) フレームワークの導入、後続の認可コントローラーとパスワード資格情報の種類はここから来ています。
3行目: ビューコントローラーは従うASAuthorizationControllerDelegate、承認の成功または失敗のコールバックを受信するために使用されます。
5 行目: 作成ASAuthorizationController、システムのログインビューと認証プロセスの開始を担当します。
6行目:ASAuthorizationPasswordProvider().createRequest()このログインでは、保存されたユーザー名とパスワードが要求されることを示します。
9 行目: 現在のオブジェクトをプロキシとして設定すると、後続の結果はこのオブジェクトに返されます。
10行目:performRequests()ログイン要求を開始します。ユーザーは iPhone または iPad で認証情報を選択して確認します。

逐語草案では、同じことについて言及していますauthorizationRequests配列は複数のリクエストを保持できます。アプリが Apple でサインインをサポートしている場合は、そこに Apple ID リクエストを入力して、ユーザーが iPhone または iPad で使用する資格情報の種類を選択できるようにすることもできます。

資格情報を使用してログインを完了する

(04:19) ユーザーが iPhone または iPad で認証情報を選択すると、システムはdidCompleteWithAuthorization。返品された場合は、ASPasswordCredential、アプリはユーザー名とパスワードを読み取り、独自のログインロジックに任せることができます。

import AuthenticationServices

extension SignInViewController {
    func authorizationController(controller: ASAuthorizationController,
        didCompleteWithAuthorization authorization: ASAuthorization) {
        if let credential = authorization.credential as? ASPasswordCredential {
            // Use the credential to sign in
        }
    }
}

キーポイント:

3行目: 認可コールバックを入れます。SignInViewController起動コードとは別に、拡張機能内にあります。
4行目:authorizationController(_:didCompleteWithAuthorization:)認可が成功した場合のプロキシ方式です。
6 行目: 置くauthorization.credentialに変換するASPasswordCredential、今度はパスワード認証情報を取得したことを確認します。
7 行目: ここからアプリの既存のログインプロセスにアクセスします。逐語的な指示は、userそしてpasswordプロパティでログインが完了します。

このコールバックでは、サーバー側の認証は完了しません。ユーザーが確認した認証情報をアプリに渡すだけです。アプリは引き続き、ユーザー名とパスワードを独自の認証サービスに送信し、セッション、サブスクリプション状態、またはコンテンツの権限を処理する必要があります。

キャンセルと失敗の処理

(04:43) ログインに失敗する場合があります。ユーザーは積極的にキャンセルすることもできます。 tvOS 15 の推奨事項は、キャンセルを通常のパスとして扱い、インターフェイスをメインのログイン入口に戻すことです。他のエラーの場合は、ユーザーは再試行するように求められます。

import AuthenticationServices

extension SignInViewController {
    func authorizationController(controller: ASAuthorizationController,
        didCompleteWithError error: Error) {
        if case ASAuthorizationError.canceled = error  { return }
        // Let the user know something went wrong
    }
}

キーポイント:

4行目:authorizationController(_:didCompleteWithError:)認可が失敗した場合の代理方式です。
6 行目: エラーが発生したかどうかを確認します。ASAuthorizationError.canceled。ユーザーがキャンセルした場合は、直接戻ってください。
7 行目: その他のエラーでは、ログインエラーがあったことをユーザーに通知し、再試行を許可する必要があります。

この分岐は非常に重要です。キャンセルは、ユーザーが現在のログインプロセスを終了したことを示します。アプリはエラーメッセージをポップアップ表示せずにメインのログインインターフェイスに戻る必要があります。

カスタムログイン方法を追加する

(06:00) システムログインビューには追加のボタンを表示できます。適切なシナリオには、手動ログイン、購入の復元、TV サービスプロバイダーアカウントの使用などが含まれます。

import AuthenticationServices

final class SignInViewController: UIViewController, ASAuthorizationControllerDelegate {
    func beginSignIn() {
        let controller = ASAuthorizationController(authorizationRequests: [
            ASAuthorizationPasswordProvider().createRequest()
        ])

        controller.customAuthorizationMethods = [
            // Sign in Manually
            .other,
            // Restore Purchase
            .restorePurchase
        ]

        controller.delegate = self
        controller.performRequests()
    }
}

キーポイント:

5 行目: まだ最初に作成しますASAuthorizationController、主なプロセスはパスワード資格情報を要求することです。
9行目: 設定customAuthorizationMethods、ログインビューに表示する追加アクションをシステムに指示します。
11行目:.other手動でログインしたり、独自のログイン方法選択インターフェイスにジャンプしたりするために使用できます。
13行目:.restorePurchaseユーザーがアプリ内購入を復元してログインまたはロック解除を完了できるようにするために使用されます。
16 行目: プロキシを設定し、パスワードログイン結果とカスタムメソッド選択結果を受信する準備をします。
17 行目: リクエストを開始すると、システムログインビューに iPhone/iPad ログインボタンとカスタムボタンの両方が表示されます。

逐語版でも言及されています.videoSubscriberAccount。アプリが TV サービスプロバイダーアカウントでのログインをサポートしている場合は、この値を使用する必要があります。

ユーザーがカスタムボタンをクリックすると、システムはdidCompleteWithCustomMethod。アプリは受信値を確認し、対応するプロセスを開始する必要があります。

import AuthenticationServices

extension SignInViewController {
    func authorizationController(controller: ASAuthorizationController,
        didCompleteWithCustomMethod method: ASAuthorizationController.CustomAuthorizationMethod) {
        switch method {
        case .other:
            // Start your manual sign-in flow
            break
        case .restorePurchase:
            // Start your restore purchase flow
            break
        default:
            break
        }
    }
}

キーポイント:

4行目:didCompleteWithCustomMethodユーザーがカスタムログイン方法を選択するとトリガーされます。
6 番線: パスswitchユーザーがどの方法を選択したかを判断します。
7行目:.other手動ログインまたはアプリ独自のログイン選択インターフェイスに対応します。
10行目:.restorePurchase購入手続きの再開に対応しました。
13 行目: デフォルトのブランチは、現在接続されていないカスタムメソッドを処理します。

短いログインエントリを設計する

(06:36) Apple が提供する tvOS ログインのベストプラクティスは、明確な「サインイン」ボタンから始めて、システムビューに限られたオプションを提供することです。

@IBAction func signInButtonPressed(_ sender: Any) {
    beginSignIn()
}

キーポイント:

行 1: ログインボタンはユーザーアクションに応答することのみを担当し、ボタンイベントに複数のログインブランチをスタックしません。
2 行目: 「unified」と入力します。beginSignIn()、によるASAuthorizationControllerシステムログインビューを表示します。

この利点は明白です。ユーザーは最初にどのログイン方法を選択するかを決める必要がありません。デフォルトのパスは、iPhone または iPad でログインすることです。追加のパスはシステムビューに配置され、数は最小限に抑えられます。

重要ポイント

やるべきこと: ビデオアプリに「iPhone でログイン」入り口を追加します。 価値がある理由: tvOS 15 のシステムログインビューでは、ユーザーが iPhone または iPad で iCloud キーチェーン認証情報を選択するように直接ガイドできるため、リモコン入力が軽減されます。 開始方法: 構成webcredentialsログインボタンで作成された関連ドメインASAuthorizationController、通りますASAuthorizationPasswordProvider().createRequest()。
何をすべきか: 再開サブスクリプションをログインビューに追加します。 実行する価値がある理由: 多くのメディアアプリの「ログイン」と「購入の復元」は、コンテンツの許可の検証につながります。customAuthorizationMethods購入の復元は、システムログインビューで明示的なオプションにすることができます。 開始方法: セットアップcontroller.customAuthorizationMethods = [.restorePurchase]、存在するdidCompleteWithCustomMethodで StoreKit 復元購入プロセスを開始します。
やるべきこと: ホームシェアリング TV に手動でログインする準備をしてください。 価値がある理由: 一部のユーザーは、認証情報を iCloud キーチェーンに保存していないか、別のアカウントを使用したいと考えています。.otherシステムビューからアプリ独自の手動ログインインターフェイスにジャンプできます。 開始方法:.other参加するcustomAuthorizationMethods、コールバックでユーザー名とパスワードの入力ページを開きます。
対処方法: TV サービスプロバイダーのアカウントを同じログインポータルに接続します。 実行する価値がある理由: 逐語的な説明、TV プロバイダーアカウントをサポートするアプリを使用する必要があります.videoSubscriberAccount。ユーザーはホーム画面に複数のボタンが並んでいる必要がありません。 開始方法: カスタムモードで追加します.videoSubscriberAccount、ユーザーは選択後、既存の TV サービスプロバイダーの承認プロセスに入ります。
対処方法: ログインのキャンセルを通常の状態として UI プロセスに書き込みます。 実行する価値がある理由: ユーザーが認証をキャンセルすると、システムは元の状態に戻ります。ASAuthorizationError.canceled。この状態は、メインのログインページに戻るのに適しています。 開始方法:didCompleteWithError最初に判断するASAuthorizationError.canceled、キャンセルする場合はメインのログインページに戻り、他のエラーの場合は再試行プロンプトが表示されます。

Simplify sign in for your tvOS apps

ハイライト

主要内容

詳細

関連するドメインを構成する

パスワード認証情報を要求する

資格情報を使用してログインを完了する

キャンセルと失敗の処理

カスタムログイン方法を追加する

短いログインエントリを設計する

重要ポイント

関連セッション

コメント