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