tencent cloud

Chat

제품 소개
제품 개요
Basic Concepts
응용 시나리오
기능 소개
계정 시스템
사용자 정보 및 관계망
메시지 관리
그룹 시스템
Official Account
Audio/Video Call
사용 제한
구매 가이드
과금 개요
요금 안내
Purchase Instructions
Renewal Guide
연체 안내
Refund Policy
다운로드 센터
SDK & Demo 소스 코드
업데이트 로그
시나리오 솔루션
Live Streaming Setup Guide
AI Chatbot
대규모 엔터테인먼트 협업 커뮤니티
Discord 구현 가이드
IM을 게임에 통합하는 방법
WhatsApp Channel-style Official Account Integration Solution
Send Red Packet
Firewall Restrictions
클라이언트 APIs
SDK API(Web)
Android
iOS & macOS
Swift
Flutter
Electron
Unity
React Native
C APIs
C++
서버 APIs
Secure authentication with UserSig
RESTful APIs
Webhooks
콘솔 가이드
New Console Introduction
애플리케이션 생성 및 업그레이드
기본 설정
기능 설정
계정 관리
그룹 관리
Official Channel Management
콜백 설정
모니터링 대시보드
Viewing Guide for Resource Packages
Real-Time Monitor
개발 보조 툴
액세스 관리
Advanced Features
FAQ
uni-app FAQs
구매
SDK 관련 질문
계정 인증
사용자 정보 및 관계망
메시지
그룹
라이브 방송 그룹
닉네임 및 프로필 사진
협약 및 인증
Service Level Agreement
컴플라이언스 인증
IM 정책
개인 정보 보호 정책
데이터 개인 정보 보호 및 보안 계약
에러 코드
문의하기
문서Chat클라이언트 APIsSwift

Swift

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2025-01-23 16:13:12
Note:
Do not use APIs of new and old versions at the same time.

Initialization and Login APIs

To use Tencent Cloud IM services, you need to initialize the SDK and log in.
API
Description
Initializes the SDK.
Uninitializes the SDK.
Add IM listener
Remove IM listener
Gets the version number.
Gets the server time.
Logs in.
Logs out.
Gets the currently logged-in user.
Gets the login status.
Gets user status information.
Sets user status for yourself.
Subscribes user status.
Unsubscribes user status.

Simple Message APIs

Use the following APIs for the sending and receiving of text and signaling (custom buffer) messages.
API
Description
Sets an event listener for simple messages (text messages and custom messages).Do not use it and addAdvancedMsgListener at the same time.
Removes the event listener for simple messages (text messages and custom messages).
Sends a one-to-one (C2C) text message.
Sends a one-to-one (C2C) custom (signaling) message.
Sends a group text message.
Sends a group custom (signaling) message.

Signaling APIs

API
Description
Adds a signaling listener.
Removes a signaling listener.
Invites a user.
Invites certain users in the group.
Cancels an invitation.
Accepts an invitation.
Rejects an invitation.
Gets the signaling information.
Adds invitation signaling (can be used for invitation signaling triggered by offline push messages for group invitations).
modify invitation.

Advanced Message APIs

If you need to send/receive rich media messages (images, videos, files, etc.) and use advanced features such as recalling messages, marking messages as read, and querying message history, use the following advanced message APIs. Do not use simple messages APIs and advanced message APIs at the same time.
API
Description
Sets an event listener for advanced messages.Do not use it and addSimpleMsgListener at the same time.
Removes the listener for advanced messages.
Creates a text message.
Creates an @ text message.
Creates a custom message.
Creates an image message.
Creates a voice message.
Creates a video message.
Creates a file message.
Creates a location message.
Creates an emoji message.
Creates a combined forward message.
Creates a single forward message.
Creates a targeted group message
Sends a message. The message object can be created using a createXXXMessage API.
Sets the Mute Notifications option for one-to-one messages.
Gets the Mute Notifications status for one-to-one messages.
Sets the Mute Notifications option for group messages.
Gets one-to-one (C2C) message history.
Gets group chat message history.
Gets message history.
Recalls a message. The message object can be created using a createXXXMessage API.
Modifies a message. The message object can be created using a createXXXMessage API.
Marks one-to-one (C2C) messages as read.
Marks group messages as read.
Marks all messages as read.
Deletes a message from local storage.
Deletes messages from local storage and the cloud.
Clears chat history with a user from local storage and the cloud.
Clears chat history of a group from local storage and the cloud.
Inserts a message in a group chat.
Inserts a message in a one-to-one chat.
Finds local messages by msgID.
Search for local messages.
Search for cloud messages.
Sends read receipts to the message sender for message which have been received.
Gets read receipts for messages which have been sent by myself.
Gets group members profile who have read ths message.
Sets message extensions
Gets message extensions
Deletes message extensions
Adds message reaction.
Removes message reaction.
Gets message reactions.
Gets all user list of message reaction.
Sets group message pinning.
Gets pinned group message list.

Group APIs

Tencent Cloud Chat SDK supports five preset group types, each of which pertains to different scenarios.
Work group (Work): users can join the group only after being invited by group members. This group type is the same as private group (Private) in earlier versions.
Public group (Public): Users can join a public group through requests, which need to be approved by the group owner or group admin.
Meeting group (Meeting): used together with TRTC to enable scenarios such as video conferencing and online education. Users can join and leave the group freely and view the message history before they join. Same as chat room (ChatRoom) in earlier versions.
Community: A user can join and leave a community freely. It is suitable for chat scenarios with a super large number of community members, such as knowledge sharing and game discussion. This feature is supported by a client with the SDK enhanced edition v5.8.1668 or later and the web SDK v2.17.0 or later. To use it, you need to purchase the Pro edition 、Pro Plus edition、Enterprise edition, and then enable it in Console, path: Applications > Your App > Chat > Configuration > Group Configuration > Community.
Audio-video group (AVChatRoom): An audio-video group allows users to join and leave freely and is suitable for scenarios such as live streaming and chat rooms with on-screen comments. There is no limit on the number of group members.
API
Description
Adds an event listener for groups.
Removes event listener for groups.
Creates a (simple) group.
Creates an (advanced) group. The group information and the initial group members can be set during group creation.
Joins a group.
Quits a group.
Deletes a group. Only the group owner and group admin can delete a group.
Gets the list of groups the current user has joined, excluding audio-video groups.
Pulls profiles of groups.
Search for local group profiles.
Search for cloud group profiles.
Modifies the profile of a group.
Initializes group attributes.
Sets group attributes.
Deletes group attributes.
Gets group attributes.
Gets the number of online group members.
Gets group member list.
Gets the profiles of specified group members.
Search for local group members.
Search for cloud group members.
Modifies the profile of a specified group member.
Mutes a group member.
Invites users to a group.
Removes a member from a group.
Sets the role for a group member.
Mark group member list .
Changes the group owner.
Gets the list of requests to join a group.
Accepts a request to join a group.
Rejects a request to join a group.
Marks the request list as read.
Gets the list of Community-groups that the current user has joined
Creates topic
Deletes topic
Modifies topic information
Gets topic list

Conversation List APIs

The conversation list is the list a user sees on the first screen after logging in to WeChat or QQ. It includes elements such as conversation node, conversation name, group name, last message, and unread count.
API
Description
Adds a conversation listener.
Removes conversation listener.
Gets the conversation list.
Gets a conversation.
Gets multiple conversations.
Gets multiple conversations (advanced API).
Deletes a conversation.
Sets draft for a conversation.
Sets custom data for a conversation.
Pins a conversation to the top.
Marks a conversation to the top.
Gets the total unread message count.
Create conversation group.
Get conversation group list.
Delete conversation group.
Rename conversation group.
Add conversations to group.
Delete conversations from group.

User Profile APIs

You can use the following APIs to query user profiles, modify your profile, and block messages from a specified user (i.e., adding a specified user to the blocklist).
API
Description
Gets users’ profiles.
Modifies one's own user profile.
Search cloud users
Blocks messages from a specified user, which means adding the user to the blocklist.
Unblocks messages from a specified user, which means removing the user from the blocklist.
Gets the blocklist.

Offline Push APIs

Use the offline push service if you want your app to receive IM messages in real time when it runs in the background. As there is currently no unified push service in the Chinese mainland, you need to Offline Push(iOS).
API
Description
Sets an APNs listener.
Configures APNS push.
Configures VOIP push.

Friend Management APIs

Tencent Cloud Chat SDK does not check friend relationships by default when sending and receiving messages. To achieve the interactive experience of "add friends first, then send messages", you can log in to the Console to modify Relationship Check. When enabled, users can only send messages to their friends. When a user sends a message to a non-friend, SDK will report a 20009 error code. The configuration path is: Applications > Your App > Chat > Configuration > Login and Message > Relationship Check.
Use the following API to add or delete friends and manage friend lists.
API
Description
Adds a Contacts listener to receive friend list and blocklist change events.
Removes Contacts listener.
Gets the friend list.
Gets the profiles of specified friends.
Sets the profile of a specified friend.
Searches for friends.
Adds a friend.
Deletes a friend.
Checks relationship with specified users.
Gets the list of friend requests.
Accepts a friend request.
Rejects a friend request.
Deletes a friend request.
Marks a friend request as read.
Creates a friend list.
Gets the information of friend lists.
Deletes friend lists.
Modifies the name of a friend list.
Adds friends to a friend list.
Deletes friends from a friend list.

이전 주제: iOS & macOS다음 주제: Flutter

도움말 및 지원

문제 해결에 도움이 되었나요?

피드백