tencent cloud

Feedback

Follow Anchors (TUILiveKit)

Last updated: 2024-12-19 16:32:21

    Description of the Feature

    In live streaming scenarios, the Follow the host feature is an important interaction method. It allows viewers to choose to follow specific hosts, thus establishing long-term interaction and follow relationships on the live streaming platform. The TUILiveKit has implemented the Follow the host feature through Chat.
    Follow feature allows users to choose other users they are interested in so that they can get the latest updates, posts, or event information promptly. You can provide personalized content recommendations based on the user's Follow list.
    Fans feature refers to the status of a user being followed by others. When User A follows User B, A becomes a Fan of B.
    Through the Follow and Fans features, social applications and websites can create an active and interconnected user network, promoting the dissemination of information and the building of communities.

    Use Instructions

    Note:
    TUILiveKit's Follow the host feature relies on the Chat Follow & Fan APIs, so you need to activate the related Package bundles for Chat. For details, please refer to the Follow&Fan documentation.
    Unfollowed Status
    Followed Status
    Broadcaster Info Panel
    
    
    
    
    
    
    
    
    
    Follow the host: You can click the
    
    button in the live room information area at the top left corner of the live streaming interface to follow the host
    Unfollow: You can click the
    
    button in the live room information area at the top left corner of the live streaming interface to unfollow the host
    View the host's fan count: You can click the live room information area at the top left corner of the live streaming interface to pop up the live room details panel, which will display the host's fan count.

    Feature customization

    If the current UI does not meet your needs, you can achieve your desired UI effects by modifying the source code. For easier UI customization, an introduction to the files related to the follow feature is provided here.
    Android
    iOS
    // File location: Android/tuilivekit/src/Main/java/com/trtc/uikit/livekit/common/uicomponent/
    
    roominfo // Directory for implementing the live room information UI component
    ├── RoomInfoDetailView.java // Specific implementation of the Live Room Information Details Panel View
    └── RoomInfoView.java // Specific implementation of the Live Room Information View. Clicking this view will show the Details Panel View
    // File location: TUILiveKit/iOS/TUILiveKit/Sources/Component/LiveInfo/
    
    LiveInfo // Implementation directory of Live Room Information UI Component
    ├── LiveInfoView.swift // Detailed implementation of Live Room Information Panel View
    └── View
    └── LiveInfoPanelView.swift // Detailed implementation of Live Room Information View, clicking this view will display the detailed panel view

    Key code

    Follow anchor

    Android
    iOS
    Java
    // File location: Android/tuilivekit/src/Main/java/com/trtc/uikit/livekit/service/impl/LiveServiceImpl.java
    
    List<String> userIDList = new ArrayList<>();
    userIDList.add("userId");
    
    V2TIMManager.getFriendshipManager().followUser(userIDList,
    new V2TIMValueCallback<List<V2TIMFollowOperationResult>>() {
    @Override
    public void onSuccess(List<V2TIMFollowOperationResult> results) {
    }
    
    @Override
    public void onError(int code, String message) {
    }
    });
    Swift
    // File location: TUILiveKit/iOS/TUILiveKit/Sources/Component/LiveInfo/RoomInfoService
    
    public func followUser(userId: String) {
    let userInfo = TUIUserInfo()
    userInfo.userId = userId
    V2TIMManager.sharedInstance().followUser([userId]) { [weak self] followResultList in
    guard let self = self, let result = followResultList?.first else { return }
    if result.resultCode == 0, !self.state.followingList.contains(where: { $0.userId == userId }) {
    self.state.followingList.insert(userInfo)
    self.getFansNumber()
    }
    } fail: { code, message in
    debugPrint("[RoomInfo] followUser failed, error:\\(code), message:\\(String(describing: message))")
    }
    }

    Unfollow anchor

    Android
    iOS
    Java
    // File location: Android/tuilivekit/src/Main/java/com/trtc/uikit/livekit/service/impl/LiveServiceImpl.java
    
    List<String> userIDList = new ArrayList<>();
    userIDList.add("userId");
    
    V2TIMManager.getFriendshipManager().unfollowUser(userIDList,
    new V2TIMValueCallback<List<V2TIMFollowOperationResult>>() {
    @Override
    public void onSuccess(List<V2TIMFollowOperationResult> results) {
    }
    
    @Override
    public void onError(int code, String message) {
    }
    });
    Swift
    // File location: TUILiveKit/iOS/TUILiveKit/Sources/Component/LiveInfo/RoomInfoService
    
    public func unfollowUser(userId: String) {
    V2TIMManager.sharedInstance().unfollowUser([userId]) { [weak self] followResultList in
    guard let self = self, let result = followResultList?.first else { return }
    if result.resultCode == 0 {
    self.state.followingList = state.followingList.filter { $0.userId != userId}
    }
    } fail: { code, message in
    debugPrint("[RoomInfo] unfollowUser failed, error:\\(code), message:\\(String(describing: message))")
    }
    }

    View anchor's follow status

    Android
    IOS
    Java
    // File location: Android/tuilivekit/src/Main/java/com/trtc/uikit/livekit/service/impl/LiveServiceImpl.java
    
    List<String> userIDList = new ArrayList<>();
    userIDList.add("userId");
    
    V2TIMManager.getFriendshipManager().checkFollowType(userIDList,
    new V2TIMValueCallback<List<V2TIMFollowTypeCheckResult>>() {
    @Override
    public void onSuccess(List<V2TIMFollowTypeCheckResult> results) {
    }
    
    @Override
    public void onError(int code, String message) {
    }
    });
    // File location: TUILiveKit/iOS/TUILiveKit/Sources/Component/LiveInfo/RoomInfoService
    
    public func isFollow(userId: String) {
    let userInfo = TUIUserInfo()
    userInfo.userId = userId
    V2TIMManager.sharedInstance().checkFollowType([state.ownerId]) { [weak self] checkResultList in
    guard let self = self, let result = checkResultList?.first else { return }
    if result.followType == .FOLLOW_TYPE_IN_BOTH_FOLLOWERS_LIST || result.followType == .FOLLOW_TYPE_IN_MY_FOLLOWING_LIST {
    if !self.state.followingList.contains(where: { $0.userId == userId }) {
    self.state.followingList.insert(userInfo)
    }
    } else {
    self.state.followingList = state.followingList.filter { $0.userId != userId}
    }
    } fail: { code, message in
    debugPrint("[RoomInfo] isFollow failed, error:\\(code), message:\\(String(describing: message))")
    }
    }

    Get number of followers

    Android
    iOS
    Java
    // File location: Android/tuilivekit/src/Main/java/com/trtc/uikit/livekit/service/impl/LiveServiceImpl.java
    
    List<String> userIDList = new ArrayList<>();
    userIDList.add("userId");
    
    V2TIMManager.getFriendshipManager().getUserFollowInfo(userIDList,
    new V2TIMValueCallback<List<V2TIMFollowInfo>>() {
    @Override
    public void onSuccess(List<V2TIMFollowInfo> results) {
    }
    
    @Override
    public void onError(int code, String message) {
    }
    });
    // File location: TUILiveKit/iOS/TUILiveKit/Sources/Component/LiveInfo/RoomInfoService
    
    public func getFansNumber() {
    V2TIMManager.sharedInstance().getUserFollowInfo([state.ownerId]) { [weak self] followInfoList in
    guard let self = self, let followInfo = followInfoList?.first else { return }
    self.state.fansNumber = Int(followInfo.followersCount)
    } fail: { code, message in
    debugPrint("[RoomInfo] getFansNumber failed, error:\\(code), message:\\(String(describing: message))")
    }
    }
    
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support