← 開発ノート一覧

ファミリー共有で解除されないとき、Flick で確認したこと

· Hui Ma

今回の調査は、ある疑問から始まりました。家族の誰かが Flick Pro の永久版を購入しているのに、別のメンバーにはなぜ購入画面が表示されるのでしょうか。そのメンバーが未成年の場合、保護者の承認や端末の購入制限は解除に影響するのでしょうか。

購入、購入の復元、起動、フォアグラウンドへの復帰という流れに沿ってコードを確認しました。その結果、起動時の処理順序に問題があり、家族で利用する際の対応にも2つの不足が見つかりました。

最初に確認すること:Apple から利用権が提供されているか

共有の対象であること、保護者の承認を待っていること、引き換えの手続きが未完了であることは、有効な購入利用権をすでに持っている状態とは異なります。アプリは、Apple が提供するトランザクションに基づいて機能を解除する必要があります。「無料で入手できる」という案内だけでは、購入が完了した証拠にはなりません。アプリ自体を無料でダウンロードできることも、別の非消耗型アプリ内課金である Pro の共有利用権を得ていることを意味しません。

最初に調べたのは Transaction.currentEntitlements です。Flick は以前からこのシーケンスを読み取り、トランザクションの検証結果、商品 ID、取り消し状態を確認していました。ownershipType == .purchased で絞り込んでいないため、.familyShared でも元から機能を解除できる実装でした。商品 ID は me.mahui.app.Flick.pro.lifetime です。

購入の復元でも、すでに AppStore.sync() を呼び出し、その後に利用権を再確認していました。Apple は、共有される一部の非消耗型アプリ内課金では、家族のメンバーが自分で購入を復元する必要があると説明しています。sync() は、起動時に自動で認証画面を出すのではなく、ユーザーが復元ボタンを押したときに呼び出すべきものです。詳しくは ファミリー共有の説明と AppStore.sync() を参照してください。

再現できた問題:価格リクエストが最初の利用権確認を遅らせていた

元の初期化タスクは、商品の名前と価格を読み込んでから、既存の利用権を確認していました。

Task {
    await loadProduct()
    await refreshEntitlements()
}

これにより、目的の異なる2つの処理の間に待ち合わせが生じていました。商品情報のリクエストが返ってこない間、最初の利用権確認も開始できず、isPurchased は初期値の false のままになります。この待ち時間は、本人による購入とファミリー共有の両方に影響していました。

アプリがアクティブになった際には別の利用権更新も行われるため、問題が表面化しない場合もあります。ただし、起動時の正しい判定を、そのライフサイクル通知に依存させるべきではありません。そこで、2つのタスクを独立して開始するようにしました。

Task { await refreshEntitlements() }
Task { await loadProduct() }

この修正は、どちらのタスクが先に実行されるかには依存しません。重要なのは、既存の利用権を読み取る処理が、価格リクエストの完了を待たなくなったことです。模擬テストでは商品リクエストを保留したままにしました。旧コードでは起動時の利用権読み取り回数が0だったのに対し、修正後は価格がまだ読み込まれていなくても、有効な共有利用権で機能を解除できました。旧コードでも商品リクエストがエラーを返した後には利用権の更新へ進むため、今回確認した不具合は、リクエストの応答を待っている間の判定の遅れです。

未成年の利用では「承認待ち」と「新規購入の禁止」を分ける

「承認と購入のリクエスト」(Ask to Buy)は、StoreKit の保留中の購入フローを使います。Flick は .pending を受け取った時点では Pro を解除せず、購入ボタンの読み込み表示を終了し、保護者の承認や別の確認手順が必要な場合があると案内します。購入が成立すると、検証済みのトランザクションが Transaction.updates を通じて届き、利用権を再確認します。

保護者がリクエストを承認しなかった場合、成立した購入トランザクションは発生しません。そのためアプリは未解除のままとなり、「保護者が拒否しました」と断定することもできません。承認待ちの状態を、購入を永続的に無効にするフラグとして保存することもしていません。拒否された後に、再度試せなくなるのを避けるためです。詳しくは Apple の Ask to Buy テストガイドを参照してください。

これとは別に、スクリーンタイムやデバイス管理によって、新しい購入が禁止される場合もあります。今回、AppStore.canMakePayments の確認を追加しました。購入画面では新規購入を開始するボタンの代わりに制限の説明を表示し、購入処理を実行する直前にもシステムの状態を読み直します。画面を開いた後に制限が変わった場合にも対応するためです。

新しい購入が禁止されても、既存の本人購入やファミリー共有による利用権は無効になりません。利用権の読み取りは通常どおり行い、購入の復元も引き続き利用できます。このフラグは年齢を判定するものではなく、デバイス管理の制限によっても false になることがあります。詳しくは canMakePayments を参照してください。

購入の復元の案内は、家族にも伝わる内容にする

復元で利用権が見つからなかった場合、以前の案内は「購入時に使ったアカウントでログインしてください」という内容でした。本人が購入した場合には理解できますが、家族のメンバーには、子どもの端末で保護者のアカウントにログインすべきだと思わせる可能性がありました。

現在は、2つの場合を分けて説明しています。本人が購入した場合は「メディアと購入」で使っている Apple Account を確認し、ファミリー共有の場合は家族が Pro を購入済みであることと、家族の購入の共有設定を確認します。家族のメンバーは、ファミリー共有に参加している自分のアカウントを使います。復元で一時的に利用権が見つからなくても、その家族の誰も Pro を購入したことがないとは限りません。

ローカルの Products.storekit にある familyShareable: true は、開発用のテスト設定で共有が有効であることを示すだけです。本番のアプリ内課金で共有が有効になっている証拠にはなりません。本番の設定、各メンバーの購入用アカウント、共有設定、トランザクションが届いているかは、引き続き確認が必要です。詳しくは Apple の共有購入に関するトラブルシューティングを参照してください。

検証できたことと、まだ検証できていないこと

今回のコード変更では、再現できた起動時の待ち時間の問題を解消し、新規購入の制限への対応と、家族向けの復元案内を追加しました。この記事の公開は、開発記録を公開したという意味です。アプリのアップデートが配信済みであることや、実際の家族アカウントによるテストが完了したことを示すものではありません。

現在も Pro が解除されない場合

まず Flick の購入画面で「購入を復元」を押してください。ファミリー共有の場合は、自分の家族アカウント、「メディアと購入」、家族の購入の共有設定を確認します。保護者の承認待ちや引き換えの手続きが未完了の場合は、先に Apple のシステム上の手続きを完了してください。それでも解除されない場合は、アプリと OS のバージョン、本人購入かファミリー共有か、復元後に表示された案内を添えて、Flick サポートまでご連絡ください。