> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/contributor/contributor-ko/social-service/ws.md). # 웹소켓 소셜 서비스는 디센트럴랜드 내에서 친구 관계를 관리하는 서버입니다. Matrix 플랫폼을 활용하며, 요청, 수락, 거절, 취소, 삭제와 같은 친구 관계 업데이트를 처리하는 공식 소스 역할을 합니다. ### 사용 사례 소셜 서비스는 친구 관계와 관련된 다음 사용 사례를 처리합니다: * 친구 관계 요청 * 친구 요청 수락 * 친구 요청 거절 * 친구 요청 취소 * 친구 삭제 * 내 모든 친구 목록 보기 * 나와 다른 사용자 사이의 공통 친구 목록 보기 ### 배경 소셜 서비스 도입 전에는 친구 데이터가 Matrix에서 직접 저장되고 조회되었습니다. 이로 인해 친구 관계 워크플로우와 신뢰할 수 없는 정보와 관련된 여러 문제가 발생했습니다. 또한 새로운 기능을 구현하는 것도 어려웠습니다. Matrix는 주로 채팅 기능을 처리하므로, 소셜 서비스는 Matrix와 상호작용하기 전에 필요한 비즈니스 로직을 적용하는 프록시 역할을 합니다. ### 아키텍처 #### 버전 기록 1. [첫 번째 버전](https://adr.decentraland.org/adr/ADR-113): 초기에는 소셜 서비스가 모든 친구와 상호 연결을 나열하는 GET 엔드포인트만 제공하는 REST API였습니다. 업데이트나 요청 전송과 관련된 기능은 없었습니다. 2. [두 번째 버전](https://adr.decentraland.org/adr/ADR-189): 이 버전에서는 친구 관계 흐름에 대한 업데이트가 도입되었습니다. 이러한 변경 사항을 해결하기 위해 WebSocket RPC 서버가 구현되었습니다. 이 서버는 필수 메시지를 처리하고, 클라이언트와의 연결을 열린 상태로 유지하여 적시에 업데이트를 제공합니다. WebSocket 연결은 또한 다음과 같은 기능을 가능하게 합니다 [존재 상태 추적](https://github.com/decentraland/adr/blob/420e63926d20166ae832e3de62dd9e3f2370cd49/content/ADR-246-poc-presence.md) 소셜 서비스 내에서. #### URL **.zone 도메인** 테스트용 및 테스트넷 사용 시의 개발 환경 서버. * [Matrix로 로그인](https://social.decentraland.zone) * [REST API](https://social.decentraland.zone) * [WebSocket API](https://rpc-social.decentraland.zone) **.org 도메인** 프로덕션 환경 서버 및 메인넷 사용 시. * [Matrix로 로그인](https://social.decentraland.org) * [REST API](https://social.decentraland.org) * [WebSocket API](https://rpc-social.decentraland.org) ### Javascript 클라이언트 사용 Javascript 클라이언트를 사용하려면 다음을 참조하세요 ### 참조용 클라이언트 구현 * [Matrix 클라이언트](https://github.com/decentraland/matrix-client) * [JS 클라이언트](https://github.com/decentraland/social-rpc-client-js) * [Rust 참조 클라이언트](https://github.com/decentraland/social-client) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.decentraland.org/contributor/contributor-ko/social-service/ws.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.