사진 선택: 사용자에게 표시되는 항목
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 가이드는 미디어 항목을 선택할 때 사용자의 경험을 이해하는 데 도움이 됩니다.
표준 Picker API 흐름에 따라 앱이 pickerUri
를 표시한 후 그리고 앱이 mediaItemsSet
가 true를 반환할 때까지 폴링하는 동안 존재를 선택합니다.
기기에서 이러한 단계를 보려면 샘플 앱을 확인하세요.
선택 세션 시작
세션을 만들고 나면 앱에서 사용자에게 pickerUri
를 표시해야 합니다.
pickerUri
를 QR 코드와 URL로 모두 표시합니다.
pickerUri
와 함께 유용한 텍스트를 제공합니다. 예를 들어 '이 코드를 스캔하여 Google 포토를 열고 항목을 선택하세요.'와 같이 안내할 수 있습니다.
- 입력 기능이 제한된 기기 (예: 키오스크, 태블릿, 스마트 TV)의 경우 텍스트 크기 및 QR 코드 너비에 관한 하드웨어 제조업체의 권장사항을 확인하세요.
사진 검색 및 선택하기
사용자가 pickerUri
에 액세스하면 Google 포토 앱 내의 사진 선택 페이지로 이동합니다.
이 페이지에는 항상 사용자의 Google 포토 라이브러리에 있는 최신 사진이 표시됩니다. 앨범, 즐겨찾기, 기타 일반적인 사진 카테고리는 직접 표시되지 않습니다. 사용자는 키워드, 날짜, 위치, 앨범 제목과 같은 다양한 기준을 사용하여 사진을 검색할 수 있습니다.
앱에서 앨범, 날짜 또는 기타 일반적인 사진 카테고리를 사용하는 경우 사용자가 Google 포토 앱에 들어간 후 검색하도록 메시지를 표시하여 사용자를 지원하세요.
예를 들어 사용자에게 특정 앨범을 공유해 달라고 요청하는 경우 사용자가 Google 포토에 연결하는 동일한 페이지에 'Google 포토에 연결한 다음 공유하려는 앨범을 검색하세요.'라는 텍스트를 포함할 수 있습니다.
검색 후 사용자는 결과에서 하나 이상의 항목을 선택할 수 있습니다.
완료 화면
사용자가 '완료' 버튼을 탭하고 선택을 완료하면 '완료' 화면이 표시됩니다. 이렇게 하면 선택 세션이 종료되고 현재 pickerUri
가 더 이상 작동하지 않습니다.
사용자에게 더 많은 사진을 선택할 수 있는 옵션을 제공하려면 새 선택 세션을 만들고 앱에 pickerUri
를 다시 표시합니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-05-08(UTC)
[[["이해하기 쉬움","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"]],["최종 업데이트: 2025-05-08(UTC)"],[[["This guide explains the user experience within the Google Photos app when selecting media items using the Picker API."],["Users initiate the process by accessing the `pickerUri` displayed in your app, which opens a photo selection page within Google Photos."],["Users can search and select photos from their Google Photos library using various criteria before confirming their choices."],["After selection, users are presented with a \"Done\" screen, and your app can re-display the `pickerUri` to allow for further selections in a new session."]]],["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"]]