API 사용 사례

Mirror API는 Glass용 서비스를 빌드하는 데 사용할 수 있는 일련의 구성요소를 제공합니다. Glass 서비스는 기존에 개발한 다른 소프트웨어와 다를 수 있기 때문에 Mirror API의 특성을 서로 어떻게 맞추어야 할지 확실하지 않을 수 있습니다.

많은 서비스가 API 사용 카테고리에 속합니다. 다음은 Mirror API의 기능을 결합하여 Glass 서비스를 만드는 방법을 보여주는 몇 가지 스토리입니다.

고양이에 관한 사실

Glass 타임라인에 콘텐츠를 제공하는 기능은 간단하지만 강력한 Google Mirror API입니다. Cat Facts 샘플 Glassware는 사용자에게 고양이에 관한 사실을 전달하며 이 흐름을 따를 수 있습니다.

  1. 사용자가 웹 애플리케이션을 방문하고 OAuth 2.0으로 인증하여 구독합니다.
  2. 서비스는 1시간마다, 모든 사용자의 Glass에 새로운 고양이과 동물에 관한 정보를 전달합니다.

타임라인 삽입 메서드를 사용하여 고양이 팩트를 구현합니다.

고양이에 관한 진실

  1. 사용자는 OAuth 2.0으로 인증하여 구독
  2. Cat Facts는 사용자 색인 및 사용자 인증 정보를 저장합니다.
  3. Cat Facts에서는 매 시간마다 새로운 고양이 팩트를 게시합니다. 이를 위해 모든 저장된 사용자를 반복하고 타임라인에 타임라인 항목을 삽입합니다.

고양이 추가

인간의 발전 단계마다 고양이 사진을 더 쉽게 배포할 수 있는 방법이 제공됩니다. Project Glass도 마찬가지입니다.

어떤 사진이든 고양이와 함께할 때 더 효과적입니다. 따라서 이 서비스를 사용하면 사용자가 임의 고양이 이미지와 Glass로 찍은 사진을 합성할 수 있습니다.

  1. 사용자가 웹 애플리케이션을 방문하고 OAuth 2.0으로 인증하여 고양이에 추가를 설치합니다.
  2. 서비스에서 사용자의 Glass에 '고양이 추가'라는 새 연락처를 만듭니다.
  3. 사용자가 사진을 찍으면 '고양이 추가'를 사용하여 사진을 공유합니다.
  4. 서비스에서 임의의 고양이 이미지를 공유된 사진에 합성합니다.
  5. 마지막으로 서비스에서 사용자의 Glass에 고양이 사진을 전송합니다.

이 서비스는 아키텍처 측면에서 다음과 같은 API 흐름을 따릅니다.

이 흐름에 고양이 추가

  1. 사용자가 OAuth 2.0으로 승인합니다. 서비스에 사용자 인증 정보가 저장됩니다.
  2. OAuth 2.0 댄스가 끝나고 나면 서비스에서 'Add a Cat That That'이라는 연락처를 삽입합니다.
  3. 그런 다음, 서비스는 timeline 컬렉션에 대한 구독을 삽입하여 이 사용자의 타임라인에서 업데이트를 구독합니다. 고양이를 고양이 추가에 완전히 설정했습니다.
  4. 시간이 지남에 따라 사용자가 사진을 찍습니다.
  5. 사용자가 '고양이 추가'를 사용하여 사진을 공유합니다. 이렇게 하면 서비스에서 이 사진과 연결된 타임라인 카드에 액세스할 수 있습니다.
  6. 서비스가 타임라인 업데이트를 구독하고 있으므로 서비스에 알림이 전송됩니다. 이 알림은 공유된 사진이 포함된 타임라인 항목으로 연결됩니다.
  7. 서비스는 알림을 검사하고 포함된 id를 사용하여 사진이 포함된 타임라인 카드를 가져옵니다.
  8. 다음으로, 타임라인 항목을 검사하고 첨부파일 ID를 사용하여 사진의 바이트를 가져옵니다.
  9. 서비스에서 임의의 고양이 이미지를 선택하여 이를 공유된 사진에 합성합니다.
  10. 마지막으로 서비스에서 새로운 타임라인 카드를 만들어 고양이 보정 사진이 첨부된 사용자의 타임라인 카드에 삽입합니다.

근처 반려동물용품점

고양이에 관한 사실이나 고양이 사진보다 더 좋은 건 실제 몸과 털을 가진 고양이입니다. Mirror API는 가장 가까운 애완동물 전문점이 어디인지 항상 알 수 있도록 함으로써 더 쉽게 관리할 수 있게 해줍니다.

사용량은 다음 흐름을 따릅니다.

  1. 사용자가 웹 애플리케이션을 방문하고 OAuth 2.0으로 인증하여 구독합니다.
  2. 서비스에 따라 사용자의 위치가 결정됩니다.
  3. 서비스에서 해당 위치 근처의 애완동물 용품점을 검색합니다.
  4. 주변의 애완동물 용품점을 나열하는 카드가 시계 왼쪽에 삽입됩니다.
  5. Glass가 서비스에 사용자 위치를 알립니다.
  6. 각 알림에서 서비스가 애완동물 전문점 검색을 반복하고 고정된 카드를 업데이트하여 가장 가까운 애완동물 전문점의 새로운 집합을 반영합니다.

이 서비스를 구현하려면 다음 API 흐름을 따라야 합니다.

근처 반려동물용품점

  1. 사용자가 OAuth 2.0으로 승인합니다. 일반적인 glass.timeline 범위 외에도 애플리케이션은 glass.location 범위 액세스도 요청합니다.
  2. OAuth 2.0 댄스가 완료된 직후 서비스는 사용자의 위치에 대한 업데이트를 구독합니다.
  3. 그런 다음, 서비스는 위치 엔드포인트에서 사용자의 최신 위치를 가져옵니다.
  4. 서비스에서 사용자 근처의 애완동물 용품점을 검색합니다.
  5. 서비스에서 반려동물용품점 검색결과를 나열하는 timeline 카드를 만듭니다. 이 카드를 시계 화면 왼쪽에 유지하기 위해 서비스에서 이 카드를 고정합니다.
  6. 사용자가 이동하면 사용자의 최근 위치가 업데이트됩니다.
  7. 서비스가 위치 업데이트를 구독하고 있으므로 서비스에 알림이 전송됩니다. 이 알림은 location 컬렉션의 latest 항목으로 연결됩니다.
  8. 서비스에 따라 서비스가 location 컬렉션에서 사용자의 latest location를 가져옵니다.
  9. 다음으로, 서비스에서 사용자 근처의 애완동물 용품점을 검색합니다.
  10. 마지막으로 서비스는 patch 메서드를 사용하여 5단계에서 삽입한 타임라인 항목의 본문을 업데이트합니다.