- 2024.09.04 업데이트
 
 
--------------------------------------------------------------------------------------------------------------
안녕하세요. 
[Android, iOS] 메이플 허브 개발자 입니다.

이전에 자유 게시판에 해당 앱을 홍보하는 글을 올렸었는데, 팁 게시판에도 앱 가이드를 작성하게 되었습니다.
이 게시글에다가 이후에 업데이트 될 내용 및 추가 된 기능들에 대한 가이드를 계속 수정 할 예정입니다.
(업데이트 내용 글은 보다 많은 사람들이 보기 위해 자유 게시판에 올릴 예정입니다.)

1. 홈 화면 
  - 이전 화면에서 API를 등록하고, 메인 캐릭터를 지정하면 나타나는 홈 화면입니다.


  1.1) 스텟 탭
    - 전투력 및 스텟, 하이퍼 스텟, 어빌리티 에 대해서 조회
    - 보스 버튼 선택 시 최근 일주일 이내 보스 세팅, 재획 으로 변경 시 최근 일주일 이내 재획 세팅. 
    - 하이퍼 스텟, 어빌리티 - 프리셋 클릭 으로 옵션 확인 가능

  1.2) 장비 탭
    - 위 스텟 탭에서 적용 된 장비로 조회
    - 해당 아이템 클릭 시 우측 이미지 처럼 나타남
    - 우측 이미지에서 드래그 및 취소 버튼으로 닫기 가능

  1.3) 스킬 탭
    - 헥사 스킬 레벨, 솔 에르다, 조각 사용 갯수, 헥사 스텟, 심볼 확인 가능

  1.4) 경험치 탭
    - 일주일 간 일일 평균 경험치, 레벨업까지 필요 경험치, 레벨업까지 일수 조회 
    - 오늘 경험치 체크 박스 체크 시 오늘 날짜 경험치 제외 후 계산

  1.5) 코디 탭
    - 단순 장착 코디 조회

2. 검색
  - 다른 캐릭터 정보 검색, 홈 화면과 동일 구성


3. 스케줄러
  -  캐릭터 별 보스, 일일, 주간 컨텐츠를 기록하는 기능입니다.

  3.1) 스케줄러 메인 화면
    - +버튼을 눌러서 캐릭터를 등록
    - +버튼 옆 리스트 버튼을 누르면 2번 이미지 처럼 캐릭터 별 클리어 보스 및 획득한 결정석 값이 표시

  3.2) 스케줄러 보스 클리어 리스트 
    - 3번 이미지의 난이도를 눌러 완료 표시가 된 것만 표시.
    - 총 획득한 결정석 값 : 모든 캐릭터의 결정석 합산 ( 보스 별 클리어 인원 적용)
    - 총 획득한 결정석 : 모든 캐릭터의 클리어 보스 수

  3.3) 스케줄러 보스, 일일, 주간 컨텐츠 기록
    - 4번 이미지에서 설정한 보스, 일일, 주간 컨텐츠만 표시.
    - 난이도 버튼을 클릭하면 클리어 체크
    - 보스를 꾹 눌러서 위아래로 위치 조절가능
    - 리셋 클리어 버튼을 누르면 클리어 체크가 초기화. 
    - 보스별 알림, 목요일 기준 자동리셋, 초기화 임박시 미진행 보스 알림 기능 들에 있어서는 아래 이유로 보류
    - 보스 클리어 이력은 API로 제공 되는게 없어서 다 수동 입니다. 추후에 나온다면 좀 더 쓰기 편하게 개선하겠습니다. (컨텐츠 클리어 이력 API 기원 !!)

  3.4) 컨텐츠 적용 화면
    - 해당 난이도를 클릭하면 3번 이미지에 표시
    - 보스 밑 인원을 클릭하면 해당 인원에 맞는 결정석 값이 2번 이미지에 적용.

4. 캘린더
  - 일정 기록 및 각종 이벤트, 알림 표시
  (저한테 가장 필요했습니다. 기존에 쓰던 캘린더에 메이플 관련 일정을 적고 싶지 않았습니다.. 그리고 선데이 메이플이나 이벤트 일정, 패치 기록들, 인게임 내 이벤트, 언제까지 보상 
수령해야 하는 것들을 보기 쉽게 정리하고 싶었어요.)


  4.1) 캘린더 메인화면
    - EVENT LIST 를 클릭하면 3번 이미지 처럼 표시 
    - 림보 이미지를 클릭하면 2번 이미지 처럼 표시
    - 업데이트 미리보기 (INVEN) 을 누르면 5번 이미지 처럼 표시. 앱 내에서 켜지기 때문에 이전버튼을 누르면 다시 앱으로 돌아옴.
      (해당 업데이트 미리보기 기능은 인벤에서 <마빡도로시> 님께 해당 게시글로 링크되도록 허락을 받고 사용했습니다. 다시 한 번 감사드립니다)

  4.3) EVENT LIST 
    - 우측 상단 적용 일자를 기준으로 인 게임내에 표시되는 이벤트 들을 표시 할 예정.
    - 각 항목을 누르면 4번 이미지 처럼 이벤트에 해당하는 이미지가 열리도록 적용 (단순 확인용)

  4.6) 일요일, 선데이 메이플
    - 선데이 메이플이 있는 일요일에 해당 6, 7 이미지 처럼 표시

  4.8) 푸시 알람
    - 해당 아이콘을 클릭하면 9번 이미지처럼 특정 시간에 푸시 알림을 설정.
    - 설정 하면 해당 시간에 핸드폰으로 푸시 알림이 옵니다. 

# 언제까지 보상을 수령해야 하는게 있을 경우 이미지로 간단하게 표시를 하고 싶은데 시간 나는대로 만들어 보겠습니다..


5. 기타
  - 각종 필요한 유틸들을 모아 놨습니다.



  5.1) 기타 탭 메인화면
    - 이벤트, 공지사항, 업데이트 는 메이플 사이트로 링크됩니다. 
    - 길드 홍보 는 길드 홍보 게시판으로 이동 됩니다. (등록 시 광고 시청 필요)
    - 인벤 은 인벤 사이트로 링크 됩니다.
    - 시뮬레이터는 아직 미흡한 부분이 많아 추후 개선 예정입니다. (단순 조회)

  5.2) 유니온
    - 캐릭터의 유니온을 자동으로 가져와서 프리셋별로 표시 해줍니다.
    - 설정 된 프리셋에 해당하는 캐릭터들을 유니온 배치 버튼을 클릭하면 3번 이미지 처럼 
       https://xenogents.github.io/LegionSolver/ 페이지로 이동 시켜 캐릭터들을 자동으로 설정해줍니다.
    - 페이지 이동이 되면, 유니온 캐릭터 산정된 공간에 맞춰 영역만 선택해서 배치하면 됩니다.
    - 프리셋에 해당하는 캐릭터들이 옮겨지니, 인 게임내 배치 확인.

  5.4) 효율표
    - EXP, 익성비, 극성비, 초성비에 해당하는 레벨별 갯수

  5.5) 도핑
    - 보스 및 사냥에 필요한 도핑들 이미지로만 

  5.6) 앱 설정
    - 공지에 대한 알림 설정 ON 체크 시 개발자가 임의로 전송하는 푸시 알람이 허용됩니다. ( 예를들어 메이플 나우 방송이 시작했으면 해당 알림을 사용해서 핸드폰으로 푸시 알림을 전송) 
    - 다크 모드 설정 시 7번 이미지처럼 앱이 전체 다크모드로 변경됩니다. ( 핸드폰 설정을 따라가게 할 수 있으나, 임의로 설정하는게 편하다 판단)

  5.8) 보유 캐릭터
    - 한창 유니온 키울 때 내가 무슨 직업을 키웠고, 뭘 안 키웠는지 체크하는데에 어려움이 있었습니다.
      그 부분을 해소하고자 만들었습니다. 
    - 8번 이미지 처럼 보유 표시
    - 해당 이미지는 맨 아래로 스크롤 해서 보이는 이미지고, 제일 상단부터 아래로 제 주관하에 
      먼저 키워야 하는 직업 순으로 배치 했습니다.

  5.9) 드랍템 분배
    - 공방 보스를 돌다가 득템을 해서 제가 드랍템을 분배해줘야 하는 상황일 때 다른 파티원들을 친추하고, 누구한테 분배를 해줬는지 헷갈렸던 부분 때문에 만들었습니다.
    - 아이템 가격 입력 후 계산 - N빵 선택 (기본 2명) - 저장하기 - 제목 및 유저 아이디 입력 - 10번 이미지
    - 10번 이미지처럼 저장한 내용들이 기록 됩니다. 유저에 대해 전부 체크하면 아래 회색 배경처럼 표시됩니다.

  5.11) 시뮬레이터 - 헥사 스킬
    - 헥사 스킬의 경우 이미지에 헥사 스킬을 클릭하면 아래에 솔에르다와 조각이 얼마나 필요한지 표시.
    - 초록색 텍스트 박스에 숫자를 변경시 해당 레벨까지 필요한 갯수로 변경
 
  5.12) 시뮬레이터 - 보약
    - 현재 해당하는 보약 이벤트에 맞게 설정
    - 추후 개선예정

  5.13 시뮬레이터 - 경험치
    - 시뮬을 돌릴 캐릭터를 입력 후 해당 화면에 맞게 입력하면 필요한 EXP 쿠폰 갯수를 알려줍니다.

  5.14 수로 빌드
    - 특정 시간에 해당하는 텍스트를 전자녀가 읽어주는 기능
    (매번 수로를 칠 때 창모드로 메모장을 키고 하다가, 아 누가 옆에서 무슨 스킬 써야 하는지 말해줬으면 좋겠네 에서 시작 됐습니다. 외우지도, 읽으면서 하기도 힘들었어.. )
    - 현재 버전도 입력한 내용을 복사 및 붙여 넣어서 다른 인원과 공유가 가능합니다. 
    - 추후 직업 별 게시판을 만들고 빌드를 올리고 가져올 수 있게 변경 할 생각입니다.
    - 작성 양식은 우측 상단 가이드 버튼을 확인 해주세요.

수로 빌드 이해를 돕기 위한 영상 첨부 
  - 실제 쓰는 빌드도 아니고 쇼츠 전환 안되게 1분만 넘겼습니다. 영상 보시면 이해가 되실겁니다!


6. 코디네이션 (기타 탭)
  - 캐릭터의 코디 기능

  6.1) 코디네이션 메인화면
    - 선택 한 캐쉬 아이템으로 코디 기능
    - 광고 제거 버튼 : 광고를 넣어 놨는데 화면을 너무 가려서 가리는 버튼을 넣어 놨습니다. 

  6.2) 코디네이션 메뉴
    - 대표 코디 가져오기 : 대표 캐릭터의 코디를 가져옵니다. (시간이 좀 걸림)
    - Slot 5개 별로 코디 저장 및 초기화가 가능합니다.

7. 채팅 탭

  1.1) 채팅 방 리스트
    - 보스 탭에서 파티 가입 및 익몬 매칭 완료 시 채팅 방이 생성됩니다.

  1.2) 파티 수락
    - 보스 탭에서 파티를 생성한 뒤 다른 유저가 해당 파티로 가입 신청을 하면 표시
    - 해당 데이터 생성 시 푸시 알람은 현재 검토 중입니다.

  1.3) 파티 신청
    - 보스 탭 파티 리스트에서 가입 신청을 한 경우 본인의 신청 내역 표시
    - 해당 데이터 생성 시 푸시 알람은 현재 검토 중입니다.

8. 채팅 방

  1.1) 채팅 방 리스트
    - 보스 탭에서 파티 가입 및 익몬 매칭 완료 시 채팅 방이 생성됩니다.

  1.2) 채팅 방
    - 파티에 가입 된 유저들끼리 실시간 대화가 가능 합니다.
    - 현재 메시지는 텍스트만 전송이 가능하게 되어있습니다. (추후 개선 예정)
    - 본인 제외 다른 유저의 메시지를 꾹 누르면 신고하기, 채팅 저장 기능이 표시됩니다.
    - 해당 데이터 생성 시 푸시 알람은 현재 검토 중입니다.

  1.3) 채팅 방 메뉴
    - 3번 이미지처럼 표시
    - 상단에 가입 된 유저들 표시 (해당 유저를 클릭하면, 간략한 정보 표시 및 리더는 추방 기능 활성화, 리더는 별 표시)
    - 대화 내용 저장하기 기능
    - 대화 방 나가기 기능 (대화 방을 나가면 파티도 탈퇴 됩니다.)

9. 파티 생성 및 가입

 1.1) 보스 탭 메인 화면
    - 첫 번째 컨테이너에는 파티 생성 및 파티 참가, 우측에는 대표 캐릭터 정보 표시 (일주일 이내 최대 전투력 정보, 우측 상단 버튼 클릭 시 대표 캐릭터 변경 페이지로 이동)
    - 두 번째 컨테이너에는 익몬 실시간 매칭 기능
    - 세 번째 컨테이너에는 본인이 가입 된 파티 표시 (클릭 시 5번 이미지처럼 표시)

  1.2) 파티 생성
    - 제목, 설명, 보스 및 난이도를 선택해야 파티를 생성 할 수 있습니다.
    - 신청 가능 조건 체크 박스 선택 시 전투력, 레벨, 인원을 선택 할 수 있습니다. (조건을 하나만 선택해도 가능, 필수 조건 아님)
    - 출발 일정 설정 체크 박스 선택 시 출발 일자 및 시간을 선택 할 수 있습니다. (필수 조건 아님)

  1.3) 파티 참가
    - 3번 이미지처럼 표시
    - 인원이 다 찼을 경우 첫 번째 파티 모집 글처럼 "풀 파티" 표시 
    - 파티 제목 아래에 첫 번째에는 보스 난이도, 두 번째에는 파티 리더, 세 번째에는 출발 일정 표시
    - 우측 끝에는 파티 별 인원 표시

  1.4) 파티 필터
    - 3번 이미지 좌측 상단 필터 버튼 클릭 시 4번 이미지처럼 필터 조건이 나타납니다.
    - 보스 및 난이도 선택해서 조회 가능
    - 출발 일자 선택해서 조회 (해당 일자 이후 데이터 조회)
    - 출발 시간 선택해서 조회 (해당 시간 이후 나머지 시간에 해당하는 데이터 조회)
    - 풀 파티 제외 체크 박스 선택 시 첫 번째 파티 처럼 "풀 파티" 표시 된 파티들 제외
    - 제목으로 조회

  1.5) 파티 상세 정보
    - 3, 4번 이미지에서 파티를 선택 시 5번 이미지 처럼 표시
    - 해당 파티의 정보를 가져와서 표시
    - 파티에 가입 되어 있는 경우 5번 이미지 처럼 파티 탈퇴하기 및 채팅 방으로 이동 버튼 표시
    - 파티 탈퇴 시 파티 및 채팅 방이 삭제됩니다. (파티의 멤버가 본인을 제외하고 한 명이라도 있으면 파티는 유지)
    - 파티에 가입 되어 있지 않은 경우 파티 가입 신청 버튼 표시 (가입 신청 시 가입 대기로 변경 됩니다.)
    - 파티 생성 시에 신청 가능 조건 및 출발 일정을 선택했으면 해당 정보도 표시 (선택하지 않으면 표시X)
    - 신청 가능 조건에 맞지 않으면, 신청 불가.
    - 파티 인원이 다 차있는 파티의 경우 인원이 다 찼다는 버튼으로 변경

10. 익몬 실시간 매칭
  1.1) 보스 탭 메인 화면
     - 첫 번째 컨테이너에는 파티 생성 및 파티 참가, 우측에는 대표 캐릭터 정보 표시 (일주일 이내 최대 전투력 정보, 우측 상단 버튼 클릭 시 대표 캐릭터 변경 페이지로 이동)
    - 두 번째 컨테이너에는 익몬 실시간 매칭 기능
    - 세 번째 컨테이너에는 본인이 가입 된 파티 표시 (익몬 파티는 표시X)

  1.2) 익몬 매칭
    - 두 번째 컨테이너에서 1극, 2극, 3극+, 기사, 승객 선택 후 START 버튼을 클릭하면 실시간으로 유저들과 매칭
    - 1극은 전투력 5천만 이상, 2극은 2천만 이상 가능 (어느 정도로 설정할지 의견 부탁 드립니다.)
    - 3극은 아무나 가능
    - 파티 매칭 인원이 4명이 되어야 채팅 방이 생성됩니다. (매칭 완료 시 알림 음 있습니다! 깜놀 주의)
    - 이미 익몬 파티에 가입되어 있는 경우에 다시 START버튼을 클릭하면, 기존 파티에 대해 탈퇴 메시지 표시 (파티가 있는 경우 매칭 불가)
    - 익몬 파티의 경우 한 명이라도 탈퇴하면, 해당 파티 해체 
    1.2.1) 기사 선택 후 매칭
      - 기사 선택 시 전투력 1억 이상만 매칭 가능 (의견 부탁 드립니다.)
      - 기사로 매칭 중인 경우 1번 이미지의 매칭 중인 기사 : 0 부분에 매칭 중인 기사의 수가 표시 (승객 분들은 해당 표시를 보고 매칭 해주시면 편합니다.)
      - 본인이 파티의 리더가 되며, 나머지 세 명은 "승객"으로 매칭 한 유저들이 가입 됩니다.
    1.2.2) 승객 선택 후 매칭
      - 아무나 승객으로 매칭 가능
      - 승객은 "기사"로 매칭 중인 인원이 있어야 파티가 생성됩니다.
      - 매칭 중인 기사가 없어도 매칭 시 30초에 한 번씩 최대 5번까지 매칭 중인 기사를 찾습니다. 
      - 개발자 본인은 매일 기사로 매칭 합니다. 많관부
이상 기능 설명은 끝입니다.


드릴 말씀 몇 가지.
1. 대부분의 데이터는 서버비를 아끼기 위해 서버에 저장하지 않습니다. (개인 핸드폰에 저장, 핸드폰 초기화 및 변경 시 데이터 유지 X)
2. 처음 입력한 API Key는 절대 다른 사람에게 공유하면 안됩니다.
  - 추후 업데이트 할 보스 파티 모집, 아이템 옥션 및 채팅 기능에 본인 아이디 인증 용으로 사용 될 수 있습니다.
3. 위에 언급한 보스 파티 모집, 아이템 옥션 및 채팅 기능은 추후 개발 예정
  - 다만, 서버 관리쪽으로 아예 무지합니다. 서버비가 얼마나 나올지, 이곳저곳 넣어둔 광고비가 어느 정도나 나올지 아예 예상이 안되기 때문에 조금 지켜 본 뒤에 개발을 진행 할까 합니다. 
  - 해당 기능들도 처음 개발이라, 시간이 꽤 소요 될 수 있습니다. 그리고 기존 기능 개선이 우선입니다!
4. 광고 
  - 이곳저곳 빈 곳 에다가 배너 광고를 넣어 놨습니다. 길드 홍보 글 등록에는 5초 영상을 봐야 등록 가능하게 해놨습니다. 의견을 들어보고 너무 불쾌한 부분이 있으면 제거 하겠습니다.
5. 앱 관리
  - 주로 캘린더에 선데이 메이플, 이벤트 리스트, 푸시공지 같은 건 제가 일일이 손을 대야 하는 부분입니다.
     최대한 놓치지 않게, 되도록 빨리 작업하겠지만, 놓치는 부분이 있으면 쪽지 부탁 드립니다 T^T.  추후 앱 내에 문의사항 기능도 추가하겠습니다.

마치며..

작성하다 보니 너무 긴 글이 되었네요. 모쪼록 많은 관심 부탁 드립니다. 
많은 피드백 부탁 드립니다.

--- 다운 링크 ---
기본 적으로 플레이스토어, 앱스토어에 메이플 허브 검색하시면 나옵니다.
- 안드로이드 : https://play.google.com/store/apps/details?id=com.maple.hub&pli=1
- 아이폰 : https://apps.apple.com/kr/app/%EB%A9%94%EC%9D%B4%ED%94%8C%ED%97%88%EB%B8%8C/id6566174099