このガイドでは、メディア アイテムを選択する際のユーザー エクスペリエンスを理解するのに役立ちます。
標準の Picker API フローに従い、アプリが pickerUri
を表示した後、アプリが mediaItemsSet
が true を返すまでポーリングしている間に選択が開始されます。
これらの手順を自分のデバイスで確認するには、サンプルアプリをご覧ください。
選択セッションを開始する
セッションの作成に成功すると、アプリはユーザーに pickerUri
を表示します。
pickerUri
を QR コードと URL の両方として表示します。pickerUri
の横に有益なテキストを配置します。たとえば、「このコードをスキャンして Google フォトを開き、アイテムを選択してください」などです。- 入力機能が制限されているデバイス(キオスク、タブレット、スマートテレビなど)の場合は、テキストサイズと QR コードの幅についてハードウェア メーカーの推奨事項を確認してください。
ランディング ページ
ユーザーが pickerUri
にアクセスすると、Google フォト アプリ内の写真選択ページが表示されます。
このページには、ユーザーの Google フォト ライブラリの最新の写真が常に表示されます。
写真を検索して選択する
Google フォト アプリでは、キーワード、日付、場所、アルバム タイトルなどのさまざまな条件を使用して写真を検索できます。
検索した結果から、ユーザーが 1 つ以上のアイテムを選択できます。
完了画面
ユーザーが [完了] ボタンを押して選択を完了すると、[完了] 画面が表示されます。
ユーザーがさらに写真を選択できるようにするには、アプリで pickerUri
を再度表示します。ユーザーが pickerUri
に 2 回目にアクセスすると、新しい選択セッションが作成されます。