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

このガイドでは、ユーザーがメディアアイテムを選択する際のエクスペリエンスについて説明します。

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

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

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

セッションの作成に成功したら、アプリでユーザーに pickerUri を表示する必要があります。

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

QR コードを表示しているスクリーンショット

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

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

アプリでアルバムや日付などの一般的な写真カテゴリを利用している場合は、ユーザーが Google フォトアプリを開いたときに検索を促して、ユーザーをサポートします。

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

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

ピッキング完了後の完了ページのスクリーンショット

ユーザーが [完了] ボタンをタップして選択を完了すると、[完了] 画面が表示されます。これにより、ピッキングセッションが終了し、現在の pickerUri は使用できなくなります。

ユーザーがより多くの写真を選択できるようにするには、新しい選択セッションを作成し、アプリで pickerUri を再度表示します。