2025 年 4 月 1 日,我们移除了 Library API 中的部分镜重。
点击此处了解详情。
照片选择:用户看到的内容
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
本指南可帮助您了解用户在选择媒体内容时的体验。
按照标准选择器 API 流程,选择会在应用显示 pickerUri
之后开始,并在应用轮询 mediaItemsSet
以返回 true 时进行。
如需在自己的设备上查看这些步骤,请查看我们的示例应用。
开始选择会话
成功创建会话后,您的应用应向用户显示 pickerUri
。
- 以二维码和网址的形式显示
pickerUri
。
- 在
pickerUri
旁边提供实用文本。例如,“扫描此二维码即可打开 Google 相册并选择您的内容。”
- 对于输入功能有限的设备(例如信息亭、平板电脑、智能电视),请查看硬件制造商关于文字大小和二维码宽度的建议。
搜索并选择照片
当用户访问 pickerUri
时,系统会将其转到 Google 相册应用内的照片选择页面。
此页面将始终显示用户 Google 相册媒体库中的最新照片。影集、收藏夹和其他常见照片类别不会直接显示。用户可以使用各种条件(例如关键字、日期、地点和相册标题)搜索照片。
如果您的应用使用相册、日期或其他常见的照片类别,请在用户进入 Google 相册应用后提示他们进行搜索,从而为他们提供帮助。
例如,如果您要求用户分享特定相册,可以在用户连接到 Google 相册的同一页面上添加以下文字:“连接到 Google 相册,然后搜索要分享的相册。”
搜索后,用户可以从搜索结果中选择一个或多个项目。
“完成”界面
用户点按“完成”按钮并完成选择后,会看到“完成”界面。这样会结束拣货会话,并且当前的 pickerUri
将不再有效。
如需为用户提供选择更多照片的选项,请创建新的选择会话,并在应用中再次显示 pickerUri
。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-09-18。
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-09-18。"],[],["The core process involves displaying a `pickerUri` (QR code and URL) to users, prompting them to access it. This takes them to Google Photos for photo selection. Users can search using keywords, dates, or locations to find specific photos. Upon selection and pressing \"Done,\" the process ends. Apps can offer to display the `pickerUri` again to initiate a new picking session, to select more items. While the app is polling for the media selection the process has begun.\n"]]