사진 선택: 사용자에게 표시되는 항목
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 가이드는 사용자가 미디어 항목을 선택할 때의 경험을 이해하는 데 도움이 됩니다.
표준 선택기 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-09-18(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-09-18(UTC)"],[],["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"]]