写真の選択: ユーザーに表示される写真

このガイドでは、メディア アイテムを選択する際のユーザー エクスペリエンスを理解するのに役立ちます。

標準の Picker API フローに従い、アプリが pickerUri を表示した後、アプリが mediaItemsSet が true を返すまでポーリングしている間に選択が開始されます。

これらの手順を自分のデバイスで確認するには、サンプルアプリをご覧ください。

選択セッションを開始する

セッションの作成に成功すると、アプリはユーザーに pickerUri を表示します。

• pickerUri を QR コードと URL の両方として表示します。
• pickerUri の横に有益なテキストを配置します。たとえば、「このコードをスキャンして Google フォトを開き、アイテムを選択してください」などです。
• 入力機能が制限されているデバイス（キオスク、タブレット、スマートテレビなど）の場合は、テキストサイズと QR コードの幅についてハードウェア メーカーの推奨事項を確認してください。

写真を検索して選択する

ユーザーが pickerUri にアクセスすると、Google フォト アプリ内の写真選択ページが表示されます。

このページには、ユーザーの Google フォト ライブラリの最新の写真が常に表示されます。アルバム、お気に入り、その他の一般的な写真カテゴリは直接表示されません。ユーザーは、キーワード、日付、場所、アルバムのタイトルなど、さまざまな条件を使用して写真を検索できます。

アプリでアルバム、日付、その他の一般的な写真カテゴリを使用している場合は、Google フォト アプリにアクセスしたユーザーに検索を促すメッセージを表示して、ユーザーをサポートします。

たとえば、ユーザーに特定のアルバムを共有するよう求める場合は、ユーザーが Google フォトに接続する同じページに、「Google フォトに接続して、共有するアルバムを検索してください」というテキストを含めることができます。

検索した結果から、ユーザーが 1 つ以上のアイテムを選択できます。

完了画面

ユーザーが [完了] ボタンを押して選択を完了すると、[完了] 画面が表示されます。

ユーザーがさらに写真を選択できるようにするには、アプリで pickerUri を再度表示します。ユーザーが pickerUri に 2 回目にアクセスすると、新しい選択セッションが作成されます。