[수다] [API] 실시간 보스, 익몬 매칭 및 채팅 기능 (Beta, 메이플허브)

최초 작성 글 : https://www.inven.co.kr/board/maple/5974/4077625

기존 앱 가이드 : https://www.inven.co.kr/board/maple/2304/40924

(위 글에는 아래 기능이 포함되어 있지 않습니다. 추후 정식 오픈 시 추가 예정)

--------------------------------------------------------------------------------------------------------------

안녕하세요. 

[Android, iOS] 메이플 허브 개발자 입니다.

이번에 제 앱에 꼭 추가하고 싶었던, 실시간 보스 매칭 기능이 추가되었습니다.

기능 오픈 시부터 어느 정도 완성된 기능을 제공해 드리면 좋겠지만, 앱 개발이 처음이다 보니 아는 것도 없이 헤딩한 거라 많은 문제점이 있을게 예상됩니다.

효율적이지 못한 소스는 앞으로 공부해서 천천히 개선해나가되, 기능적인 측면에서는 사용자분들께 의견을 받고자 미 완성인 베타 테스트 버전을 공개하게 되었습니다.

현재 배포는 iOS 쪽에만 배포가 완료된 상태입니다.

iOS 쪽에만 배포한 이유는 매칭 기능이 베타 버전인 만큼 여러 명이 사용하다 보면 문제도 많이 발견되고, 개선해야

할 부분도 많이 발견되어서 빠르게 수정해서 버전을 업데이트해야 하는데 

iOS는 빠르면 하루 만에 배포가 완료되는 반면 안드로이드는 짧으면 3일, 길면 일주일까지도 걸리기 때문에 

피드백으로 인한 업데이트 반영이 너무 느려서 iOS 사용자분들과 개선한 뒤 어느 정도 문제가 개선되면

안드로이드 쪽에도 개선된 버전으로 배포할 예정입니다.

기타 탭에 문의 사항(오픈 채팅) 및 현재 게시 글에 피드백 부탁 드립니다!

 

--------------------------------------------------------------------------------------------------------------

아래 이미지들은 안드로이드 기준 다크 모드 설정 된 이미지입니다.

1. 홈 화면 탭 변경

  1.1) 검색 탭 -> 커뮤니티 탭 변경

    - 기존 검색 탭에 기능이 홈 탭에 우측 상단 검색 버튼으로 이전 되었습니다.

  1.2) 커뮤니티 탭

    - 커뮤니티 탭 클릭 시 3번 이미지처럼 새로운 탭으로 변경

    - 3번 이미지 우측 하단 나가기 탭을 누르면 기존 홈 탭으로 이동 됩니다.

  1.3) 1번 이미지 우측 상단 조회 옵션 변경

    - 기존 보스, 재획 옵션에 실시간 옵션이 추가되었습니다.

    - 실시간 옵션 선택 시 최근에 게임이 종료 된 시점 정보를 가져옵니다.

    - 보스 : 일주일 이내 최대 전투력 시점 정보, 재획 : 일주일 이내 최대 경험치 획득 % 시점 정보

2. 채팅 탭

  1.1) 채팅 방 리스트

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

  1.2) 파티 수락

    - 보스 탭에서 파티를 생성한 뒤 다른 유저가 해당 파티로 가입 신청을 하면 표시

    - 해당 데이터 생성 시 푸시 알람은 현재 검토 중입니다.

  1.3) 파티 신청

    - 보스 탭 파티 리스트에서 가입 신청을 한 경우 본인의 신청 내역 표시

    - 해당 데이터 생성 시 푸시 알람은 현재 검토 중입니다.

3. 채팅 방

  1.1) 채팅 방 리스트

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

  1.2) 채팅 방

    - 파티에 가입 된 유저들끼리 실시간 대화가 가능 합니다.

    - 현재 메시지는 텍스트만 전송이 가능하게 되어있습니다. (추후 개선 예정)

    - 본인 제외 다른 유저의 메시지를 꾹 누르면 신고하기, 채팅 저장 기능이 표시됩니다.

    - 해당 데이터 생성 시 푸시 알람은 현재 검토 중입니다.

  1.3) 채팅 방 메뉴

    - 3번 이미지처럼 표시

    - 상단에 가입 된 유저들 표시 (해당 유저를 클릭하면, 간략한 정보 표시 및 리더는 추방 기능 활성화, 리더는 별 표시)

    - 대화 내용 저장하기 기능

    - 대화 방 나가기 기능 (대화 방을 나가면 파티도 탈퇴 됩니다.)

4. 파티 생성 및 가입

 1.1) 보스 탭 메인 화면

    - 첫 번째 컨테이너에는 파티 생성 및 파티 참가, 우측에는 대표 캐릭터 정보 표시 (일주일 이내 최대 전투력 정보, 우측 상단 버튼 클릭 시 대표 캐릭터 변경 페이지로 이동)

    - 두 번째 컨테이너에는 익몬 실시간 매칭 기능

    - 세 번째 컨테이너에는 본인이 가입 된 파티 표시 (클릭 시 5번 이미지처럼 표시)

  1.2) 파티 생성

    - 제목, 설명, 보스 및 난이도를 선택해야 파티를 생성 할 수 있습니다.

    - 신청 가능 조건 체크 박스 선택 시 전투력, 레벨, 인원을 선택 할 수 있습니다. (조건을 하나만 선택해도 가능, 필수 조건 아님)

    - 출발 일정 설정 체크 박스 선택 시 출발 일자 및 시간을 선택 할 수 있습니다. (필수 조건 아님)

  1.3) 파티 참가

    - 3번 이미지처럼 표시

    - 인원이 다 찼을 경우 첫 번째 파티 모집 글처럼 "풀 파티" 표시 

    - 파티 제목 아래에 첫 번째에는 보스 난이도, 두 번째에는 파티 리더, 세 번째에는 출발 일정 표시

    - 우측 끝에는 파티 별 인원 표시

  1.4) 파티 필터

    - 3번 이미지 좌측 상단 필터 버튼 클릭 시 4번 이미지처럼 필터 조건이 나타납니다.

    - 보스 및 난이도 선택해서 조회 가능

    - 출발 일자 선택해서 조회 (해당 일자 이후 데이터 조회)

    - 출발 시간 선택해서 조회 (해당 시간 이후 나머지 시간에 해당하는 데이터 조회)

    - 풀 파티 제외 체크 박스 선택 시 첫 번째 파티 처럼 "풀 파티" 표시 된 파티들 제외

    - 제목으로 조회

  1.5) 파티 상세 정보

    - 3, 4번 이미지에서 파티를 선택 시 5번 이미지 처럼 표시

    - 해당 파티의 정보를 가져와서 표시

    - 파티에 가입 되어 있는 경우 5번 이미지 처럼 파티 탈퇴하기 및 채팅 방으로 이동 버튼 표시

    - 파티 탈퇴 시 파티 및 채팅 방이 삭제됩니다. (파티의 멤버가 본인을 제외하고 한 명이라도 있으면 파티는 유지)

    - 파티에 가입 되어 있지 않은 경우 파티 가입 신청 버튼 표시 (가입 신청 시 가입 대기로 변경 됩니다.)

    - 파티 생성 시에 신청 가능 조건 및 출발 일정을 선택했으면 해당 정보도 표시 (선택하지 않으면 표시X)

    - 신청 가능 조건에 맞지 않으면, 신청 불가.

    - 파티 인원이 다 차있는 파티의 경우 인원이 다 찼다는 버튼으로 변경

5. 익몬 실시간 매칭

  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번까지 매칭 중인 기사를 찾습니다. 

      - 개발자 본인은 매일 기사로 매칭 합니다. 많관부

--------------------------------------------------------------------------------------------------------------

6. 업데이트 내용 (2024-09-27, 추후 개선 내용은 아래에 계속 수정 예정입니다.

 - 

--------------------------------------------------------------------------------------------------------------

드릴 말씀.

1. 혼자 독학으로 앱을 개발하고 그 기간조차 4개월 정도로 짧아, 모든 부분에서 부족 합니다. 해당 부분 감안해주시면 감사합니다!

2. 기존 검색 탭이 커뮤니티 탭으로 변경되면서, 기존 수로 기능도 커뮤니티로 이동 되었습니다. 이번 보스 매칭 기능이 개선 된 이후에 수로 빌드 관련해서 캐릭터 별 유저들끼리 공유 할 수 있도록 개선 할 예정입니다.

3. 현재 커뮤니티 탭에 추후 유저들끼리 아이템을 사고 팔 수 있도록 옥션도 추가 할 예정입니다. 해당 기능도 이번 보스 매칭 기능 개선 이후에 진행 할 예정입니다.

4. 베타 테스트 버전이라 아직 정상적으로 이용하기 힘드실 수 있습니다.

5. Nexon Open Api로 발급 받은 API Key는 절대 다른 사람에게 공유하면 안됩니다!

--------------------------------------------------------------------------------------------------------------

많은 관심과 피드백 부탁 드립니다.

감사합니다.

--- 다운 링크 ---

기본 적으로 플레이스토어, 앱스토어에 메이플 허브 검색하시면 나옵니다. 

- 안드로이드 : 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