📄게더타운 ApiFactory 이용가이드
1. Config값(API키, 맵ID, 룸ID) 얻는 방법
▶ API키 얻는방법
- 게더타운에 로그인 한 후, 새 탭을 열고 "https://gather.town/apikeys" 로 접속해주세요.
- 'generate new key’를 클릭하면 'API키' 값을 얻을 수 있습니다.
- API 키 값은 계정에 대한 고유번호이기 때문에, 유출되면 맵을 해킹 당할 수 있는 위험이 있으니, 절대 다른 사람에게 공유하시면 안됩니다.
Preview
▶ 맵 ID 얻는방법
- 게더타운 맵에 접속했을 때, 주소창에서 'app/' 이후의 값이 '맵 ID' 입니다.
Preview
▶ 룸 ID 얻는방법
- 맵 메이커에서 Rooms탭에 나와있는 것이 '룸 이름' 입니다.
- 사진에서는 empty-room-small-brick, taste로 두개의 룸 이름이 존재하네요.
Preview
2. 맵파일 추출하기
- Config값 (API키 , 맵 ID, 룸 ID)을 모두 입력하신 후, 맵 파일 추출을 눌러주세요.
- 값이 정확하게 입력 되었다면, 아래 영상과 같이 맵 파일이 다운로드 됩니다.
Preview
3. 맵파일 적용하기
- Config값 (API키 , 맵 ID, 룸 ID)을 모두 입력해 주세요.
- 추출한 맵 파일을 업로드 하신 후, ok버튼을 눌러주세요.
Preview
4. 배경음악 넣기
- Config값 (API키 , 맵 ID, 룸 ID)을 모두 입력해 주세요.
- Config입력창 바로 밑에 입력칸에서 오브젝트 ID를 선택해주세요.
( 이후, 배경음악 정보를 가져올 때 사용 - 배경음악 정보 로드하기) - 음악Url - 배경음악으로 사용하실 Url을 입력해주세요.
- 게더타운에서 유효한 배경음악 Url만드는 방법 보러가기
( 잘못된 Url입력시 오브젝트만 생성되고 음악이 들리지 않습니다. ) - x좌표, y좌표 : 배경음악 오브젝트가 생성될 위치의 좌표를 적어주세요.
- 범위 : 배경음악의 범위를 적어주세요 (0 ~ 1000) - 범위는 1당 1칸입니다.
- 볼륨 : 배경음악의 볼륨을 적어주세요 (0 ~ 1)
- loop : 배경음악의 반복여부를 체크해주세요. 체크 O : 무한 반복, 체크 X : 한번만 실행
Preview
5. 배경음악 정보 로드한 후, 정보 바꾸기
- Config값 (API키 , 맵 ID, 룸 ID)을 모두 입력해 주세요.
- 이전에 배경음악을 등록했던 ID를 선택한 후, 로드하기 버튼을 눌러주세요.
- 오브젝트 ID에 매치되는 정보가 자동으로 로드됩니다.
- 배경음악 정보를 바꾸신 후, ‘배경음악 넣기’ 버튼을 누르시면 바뀐 정보로 오브젝트가 재설치 됩니다.
Preview
※ 참고 : 게더타운에서 유효한 배경음악 Url만드는 방법
- 준비물 : 음악파일, 구글드라이브 아이디
- 구글 드라이브에 Mp3파일 업로드 후 , 링크 복사하기 - 아래 이미지 순서대로 따라해주세요.
- 아래 링크로 접속해주세요.
- 복사한 링크를 입력한 후, ‘Create Direct Link’ 클릭
- Output link에 생성된 링크를 복사해서 게더타운 배경음악 url로 이용해주시면 됩니다.
Preview
Preview
Preview