Case Document 프로토콜

1. 파일 한눈에 보기

맨 위 객체의 키는 다섯 개예요.

2. 형식 버전

• 앱은 저장할 때마다 내용에 맞춰 버전을 다시 정해요. 잠긴 증거를 모두 빼면 1로, 하나라도 더하면 2로 저장해요.
• 앱이 읽을 수 있는 버전보다 높은 파일을 열면 "더 새로운 버전의 편집기로 만든 사건이에요. 앱을 업데이트한 뒤 다시 가져와 주세요."라고 안내해요. 이때 제목 · 장르 · 현장 배경만 읽어서 업데이트 안내 화면에 보여 줘요.
• 형식 버전 2(잠긴 증거)는 Casebook 26.10.1 이상에서 열려요. 26.10.0은 형식 버전 1까지 읽어요.
• 그래서 잠긴 증거가 없는 사건은 1로 두어야 형식 버전 2를 모르는 예전 앱에서도 열려요.

3. caseFile

사건 내용이에요. "선택"이라고 적힌 키는 빼도 되고, 빼면 기본값으로 읽어요. 필수 키도 빈 문자열이나 빈 배열은 넣을 수 있지만, 9장의 검사에 걸릴 수 있어요.

4. 증거

현장 증거(sceneEvidence의 항목). 키는 모두 필수예요.

문서 증거(documentEvidence의 항목). 키는 모두 필수예요.

5. 관계자와 진술

interviews의 항목이에요. 키는 모두 필수예요. 앱은 관계자 전원을 범인 후보로 보여 줘요.

speaker는 holmes(탐정의 질문) 또는 interviewee(관계자의 답)예요.

6. 장르 · 선택지 · 정답 · 힌트

장르마다 추리 문항 세 개(누가 · 왜 · 어떻게)의 이름과 기본 선택지가 달라요. motiveOptions · methodOptions를 빼면 아래 기본 선택지로 읽어요.

선택지(motiveOptions · methodOptions의 항목)는 { "id": 문자열, "title": 문자열 }이에요. id는 정답 비교와 저장에 쓰고, 화면에는 title이 보여요. 기본 선택지를 고치거나 더해도 돼요.

정답(solution). 키는 모두 필수예요.

힌트(hints)는 { "culprit": 문자열, "motive": 문자열, "method": 문자열 }이에요. 장르마다 문항 이름은 달라도 키 이름은 같아요. 채점과 힌트를 보여 주는 방식은 사건 제작 가이드 1장에 있어요.

7. 잠긴 증거(unlocks)

처음에는 잠겨 있다가 단서를 확인하거나 답을 맞히면 열리는 증거예요. 하나라도 있으면 형식 버전 2예요.

answer의 키예요.

세 방법 모두 한글은 자모가 나뉘어 들어와도 같은 글자로 봐요.

8. 이미지

• images는 이미지 이름을 키로, 이미지 파일 내용을 Base64 문자열로 담은 객체예요.
• 키는 caseFile 안의 이미지 이름(backdropImageName · clientPortraitImageName · 현장 증거의 imageName · 관계자의 portraitImageName)과 똑같아야 해요. 이름만 있고 images에 그 키가 없으면 그 자리가 빈 칸으로 보여요.
• 이미지 이름은 비어 있으면 안 되고, .으로 시작하거나 / · \ · :를 넣을 수 없어요. 어기면 "사건 파일 안의 이미지 이름이 올바르지 않아요"라며 파일을 열지 않아요.
• 사건에서 쓰지 않는 이미지는 앱이 저장할 때 빼요.
• 사진 없이 만들 때는 images를 {}로, 이미지 이름 칸을 모두 ""로 두고, 가져온 뒤 앱 편집기에서 사진을 넣어요.

9. 앱이 검사하는 것

플레이할 수 없는 문제. 편집기의 '확인할 점'에 나오고, 하나라도 있으면 플레이할 수 없어요.

1. title · story가 비어 있지 않아요.
2. 현장 증거가 하나 이상, 관계자가 한 명 이상이에요.
3. solution.culpritID가 관계자 중 한 명의 id예요.
4. motiveOptions · methodOptions는 각각 두 개 이상이고, title이 빈 것이 없고, 같은 배열 안에서 id가 겹치지 않아요.
5. solution.motive · solution.method가 각 선택지에 있는 id예요.
6. solution.keyEvidenceIDs가 하나 이상이고, 모두 있는 증거의 id예요.
7. 현장 증거 · 문서 증거 · 관계자의 id가 서로 겹치지 않아요.
8. hints의 세 문장이 모두 비어 있지 않아요.

unlocks가 있으면 아래도 검사해요.

9. evidenceID는 있는 현장 · 문서 증거이고, 한 증거는 한 번만 잠가요.
10. from에는 있는 증거 · 관계자만 넣고, 잠긴 증거 자신이나 같은 단서를 두 번 넣지 않아요.
11. answer가 없으면 from이 비면 안 돼요. needCount는 1 이상, from 개수 이하예요.
12. answer.prompt가 비어 있지 않고, accepted가 하나 이상이며 비교 방법을 적용해도 비지 않아요(digits면 숫자가 있어야 해요).
13. 막다른 길이 없어요. 처음부터 열린 증거와 모든 관계자에서 시작해 확인을 이어 가면 모든 잠금이 열려요(답 잠금은 조건을 채우면 열 수 있다고 봐요).

사진이 빠진 곳. 플레이는 되지만 그 자리가 빈 칸으로 보여요. 편집기의 '확인할 점'과 공공 사건기록보관소에 올리기 전 검사에 나와요.

• 현장 배경 · 현장 증거 · 관계자 사진의 이름이 비어 있을 때
• 이름은 있는데 images에 그 이미지가 없거나 비어 있을 때(의뢰인 사진도 이때는 알려요. 의뢰인 사진은 이름을 비워 두면 기본 아이콘을 써요.)

10. 예시

형식 버전 2(잠긴 증거 하나)인 지어낸 사건이에요. images의 값은 줄여 적었어요. 실제 파일에는 이미지 파일 전체를 Base64로 넣어야 열려요.

{
  "formatVersion": 2,
  "caseFile": {
    "id": "case.glass-greenhouse",
    "title": "유리 온실의 사라진 난초",
    "clientName": "큐 식물원 관리인 해리엇 웨스트",
    "briefing": "식물원 유리 온실에서 하룻밤 사이에 귀한 난초가 사라졌다. 문은 안에서 잠겨 있었다.",
    "clientRequest": "",
    "clientPortraitImageName": "",
    "genre": "theft",
    "backdropImageName": "greenhouse.jpg",
    "sceneEvidence": [
      {
        "id": "evidence.cut-glass",
        "imageName": "cut-glass.jpg",
        "caption": "잘린 유리창",
        "detail": "지붕 가까운 유리 한 장이 안쪽에서 잘려 있다.",
        "immersivePlacement": { "x": 0, "y": 0.1, "z": -1 }
      }
    ],
    "documentEvidence": [
      {
        "id": "document.ledger",
        "title": "출입 장부",
        "body": "밤 10시 이후 서명은 정원사 톰 한 사람뿐이다."
      }
    ],
    "interviews": [
      {
        "id": "person.tom",
        "personName": "톰 베이커 (정원사)",
        "role": "suspect",
        "portraitImageName": "tom.jpg",
        "transcript": [
          { "id": "l1", "speaker": "holmes", "text": "어젯밤 온실 열쇠는 누가 가지고 있었나요?" },
          { "id": "l2", "speaker": "interviewee", "text": "제가요. 하지만 10시에 문을 잠그고 나왔습니다." }
        ]
      },
      {
        "id": "person.lucy",
        "personName": "루시 그레이 (수집가)",
        "role": "suspect",
        "portraitImageName": "lucy.jpg",
        "transcript": [
          { "id": "l1", "speaker": "holmes", "text": "그 난초를 사려고 하셨다고요?" },
          { "id": "l2", "speaker": "interviewee", "text": "값을 불렀다가 거절당했어요. 그뿐이에요." }
        ]
      }
    ],
    "motiveOptions": [
      { "id": "greed", "title": "금전적 이득" },
      { "id": "collectorObsession", "title": "수집 집착" }
    ],
    "methodOptions": [
      { "id": "insiderKey", "title": "내부자의 열쇠" },
      { "id": "breakIn", "title": "외부 침입" }
    ],
    "solution": {
      "culpritID": "person.tom",
      "motive": "greed",
      "method": "insiderKey",
      "keyEvidenceIDs": ["document.ledger"]
    },
    "hints": {
      "culprit": "출입 장부에 남은 이름을 다시 보세요.",
      "motive": "난초가 누구에게 팔릴 수 있었는지 생각해 보세요.",
      "method": "잘린 유리는 어느 쪽에서 잘렸나요?"
    },
    "story": "정원사 톰은 수집가에게 난초를 팔기로 하고 열쇠로 온실에 들어갔다. 침입처럼 보이려고 유리를 안쪽에서 잘랐지만, 출입 장부의 서명이 그를 가리켰다.",
    "unlocks": [
      {
        "evidenceID": "document.ledger",
        "from": ["evidence.cut-glass", "person.tom"],
        "answer": { "prompt": "장부 상자의 번호는?", "accepted": ["1887"], "match": "digits" }
      }
    ]
  },
  "images": {
    "greenhouse.jpg": "/9j/4AAQSkZJRg...",
    "cut-glass.jpg": "/9j/4AAQSkZJRg...",
    "tom.jpg": "/9j/4AAQSkZJRg...",
    "lucy.jpg": "/9j/4AAQSkZJRg..."
  }
}