채널 사용자 관리

1. 채널에 사용자 초대하기

채널에 사용자를 초대할 수 있습니다.

채널의 Owner가 아니어도 초대가 가능합니다.

Objective-C

[[TalkPlus sharedInstance] addMemberToChannel:channel 
    userIds:userIds 
    success:^(TPChannel *tpChannel) {
    // SUCCESS
} failure:^(int errorCode, NSError *error) {
    // FAILURE
}];

Swift

TalkPlus.sharedInstance()?.addMember(to: channel,
                                     userIds: userIds,
                                     success: { tpChannel in
  // SUCCESS
}, failure: { (errorCode, error) in
  // FAILURE
})

2. 채널에서 사용자 제거하기

채널에 참여한 사용자를 제거할 수 있습니다.

채널의 Owner만 수행 가능합니다.

Objective-C

[[TalkPlus sharedInstance] removeMemberToChannel:channel 
    userIds:userIds 
    success:^(TPChannel *tpChannel) {
    // SUCCESS
} failure:^(int errorCode, NSError *error) {
    // FAILURE
}];

Swift

TalkPlus.sharedInstance()?.removeMember(to: channel,
                                     userIds: userIds,
                                     success: { tpChannel in
  // SUCCESS
}, failure: { (errorCode, error) in
  // FAILURE
})

3. 채널 사용자 목록 가져오기

채널에서 사용자 목록을 가져옵니다.

채널 참여자 목록을 반환하지 않는 SUPER 채널의 경우에도 참여자를 반환합니다.

Objective-C

[[TalkPlus sharedInstance] getChannelMembers:tpChannel 
    lastUser:lastUser 
    success:^(NSArray<TPMember *> *tpUsers, BOOL hasNext) {
  // SUCCESS
  // If 'hasNext' is YES, call this method with the last object in 'tpUsers'.
} failure:^(int errorCode, NSError *error) {
  // FAILURE
}];

Swift

TalkPlus.sharedInstance()?.getChannelMembers(tpChannel,
  last: lastUser,
  success: { tpMembers, hasNext in
  // SUCCESS
  // If 'hasNext' is true, call this method with the last object in 'tpMembers'.
}, failure: { (errorCode, error) in
  // FAILURE
})

4. 사용자 차단하기

채널에 참여한 사용자를 차단합니다.

• 채널의 Owner만 수행 가능합니다.

• 차단된 사용자는 즉시 채널에서 퇴장당하며 차단해제가 될 때 까지 들어올 수 없습니다.

Objective-C

[[TalkPlus sharedInstance] banMemberToChannel:channel 
    userIds:userIds 
    success:^(TPChannel *tpChannel) {
    // SUCCESS
} failure:^(int errorCode, NSError *error) {
    // FAILURE
}];

Swift

TalkPlus.sharedInstance()?.banMember(to: channel,
                                     userIds: userIds,
                                     success: { tpChannel in
  // SUCCESS
}, failure: { (errorCode, error) in
  // FAILURE
})

5. 사용자 차단 해제하기

채널에서 차단 되었던 사용자를 차단 해제합니다.

채널의 Owner만 수행 가능합니다.

Objective-C

[[TalkPlus sharedInstance] unBanMemberToChannel:channel 
    userIds:userIds 
    success:^(TPChannel *tpChannel) {
    // SUCCESS
} failure:^(int errorCode, NSError *error) {
    // FAILURE
}];

Swift

TalkPlus.sharedInstance()?.unBanMember(to: channel,
                                     userIds: userIds,
                                     success: { tpChannel in
  // SUCCESS
}, failure: { (errorCode, error) in
  // FAILURE
})

6. 차단된 사용자 목록 가져오기

채널에서 차단 되었던 사용자 목록을 가져옵니다.

채널의 Owner만 수행 가능합니다.

Objective-C

[[TalkPlus sharedInstance] getBanUsersFromChannel: tpChannel
  lastUser: tpLastUser
  success:^(NSArray<TPUser *> *tpUsers, BOOL hasNext) {
  // SUCCESS
} failure:^(int errorCode, NSError *error) {
  // FAILURE
}];

Swift

TalkPlus.sharedInstance()?.getBanUsers(from: tpChannel,
  last: tpLastUser,
  success: { tpUsers, hasNext in
  // SUCCESS
}, failure: { (errorCode, error) in
  // FAILURE
})

7. 사용자 Mute

채널에 참여한 특정 사용자가 메시지 발송을 못 하도록 막는 mute 기능을 제공합니다.

채널의 Owner만 수행 가능합니다.

Objective-C

[[TalkPlus sharedInstance] muteMemberToChannel:channel 
    userIds:userIds 
    expireInMinutes:expireInMinutes
    success:^(TPChannel *tpChannel) {
    // SUCCESS
} failure:^(int errorCode, NSError *error) {
    // FAILURE
}];

Swift

TalkPlus.sharedInstance()?.muteMember(to: channel,
                                     userIds: userIds,
                                     expireInMinutes: expireInMinutes,
                                     success: { tpChannel in
  // SUCCESS
}, failure: { (errorCode, error) in
  // FAILURE
})

8. 사용자 Mute 해제

채널 사용자의 mute 상태를 해제할 수 있습니다.

채널의 Owner만 수행 가능합니다.

Objective-C

[[TalkPlus sharedInstance] unMuteMemberToChannel:channel 
    userIds:userIds 
    success:^(TPChannel *tpChannel) {
    // SUCCESS
} failure:^(int errorCode, NSError *error) {
    // FAILURE
}];

Swift

TalkPlus.sharedInstance()?.unMuteMember(to: channel,
                                     userIds: userIds,
                                     success: { tpChannel in
  // SUCCESS
}, failure: { (errorCode, error) in
  // FAILURE
})

9. Mute 처리된 사용자 목록 가져오기

채널에서 mute 처리 되었던 사용자 목록을 가져옵니다.

채널의 Owner만 수행 가능합니다.

Objective-C

[[TalkPlus sharedInstance] getMutedChannelMembers: tpChannel
  lastUser: tpLastMember
  success:^(NSArray<TPMember *> *tpMembers, BOOL hasNext) {
  // SUCCESS
} failure:^(int errorCode, NSError *error) {
  // FAILURE
}];

Swift

TalkPlus.sharedInstance()?.getMutedChannelMembers(tpChannel,
  lastUser: tpLastUser,
  success: { tpMembers, hasNext in
  // SUCCESS
}, failure: { (errorCode, error) in
  // FAILURE
})

10. 사용자 Peer-Mute

채널에 참여한 특정 사용자의 메시지를 차단합니다.

• 로그인 된 자신의 계정에만 특정 사용자에 대한 메시지 차단 효과가 적용됩니다. (다른 유저는 정상적으로 차단된 유저의 메시지를 볼 수 있음)

• Peer Mute / Unmute 는 Push Notification를 포함한 별도의 이벤트가 제공되지 않습니다.

• 채널 소유자(Owner)가 아니더라도, 채널에 참여한 특정 사용자의 메시지를 차단할 수 있습니다.

• expireInMinutes 파라미터를 사용하면 Peer-Mute가 N분 후에 자동 해제되도록 지정할 수 있으며, 기본값은 0입니다 (자동 해제 없음)

Objective-C

[TalkPlus.sharedInstance mutePeerToChannel:channel
        userIds:@[userId]
        expireInMinutes:0
        success:^(TPChannel *tpChannel, NSArray<TPMember *> *mutedPeers) {
   // SUCCESS (성공 시, 차단된 사용자 목록 전달 됨)                       
} failure:^(int errorCode, NSError *error) {
    // FAILURE
}];

Swift

TalkPlus.sharedInstance()?.mutePeer(to: channel,
                                    userIds: [userId],
                                    expireInMinutes: 0,
                                    success: { channel, mutedPeers in
   // SUCCESS (성공 시, 차단된 사용자 목록 전달 됨)                                         
},failure: { errorCode, error in
    // FAILURE
})

11. Peer-Mute 된 사용자 목록 가져오기

채널에 Peer-Mute 된 사용자 목록을 가져옵니다.

Objective-C

[TalkPlus.sharedInstance getMutedPeers:channel
    lastUser:lastUser
    success:^(NSArray<TPMember *> *mutedPeers, hasNext) {
    // SUCCESS 
    // If 'hasNext' is YES, call this method with the last object in 'mutedPeers'.         
} failure:^(int errorCode, NSError *error) {
    // FAILURE
}];

Swift

TalkPlus.sharedInstance()?.getMutedPeers(channel,
    lastUser: lastUser,
    success: { mutedPeers, hasNext in
    // SUCCESS
    // If 'hasNext' is true, call this method with the last object in 'mutedPeers'.                                           
}, failure: { errorCode, error in
    // FAILURE
})

12. 사용자 Peer-Mute 해제

채널에 참여한 특정 사용자의 메시지 차단을 해제합니다.

• Peer Mute / Unmute 는 Push Notification를 포함한 별도의 이벤트가 제공되지 않습니다.

• 채널 소유자(Owner)가 아니더라도, 채널에 참여한 특정 사용자의 메시지 차단을 해제할 수 있습니다.

Objective-C

[TalkPlus.sharedInstance unMutePeerToChannel:channel
        userIds:@[userId]
        success:^(TPChannel *tpChannel, NSArray<TPMember *> *unMutedPeers) {
   // SUCCESS (성공 시, 차단 해제된 사용자 목록 전달 됨)                   
} failure:^(int errorCode, NSError *error) {
    // FAILURE
}];

Swift

TalkPlus.sharedInstance()?.unMutePeer(to: channel,
                                     userIds: [userId],
                                     success: { tpChannel, unMutedPeers in
   // SUCCESS (성공 시, 차단 해제된 사용자 목록 전달 됨)                   
}, failure: { (errorCode, error) in
  // FAILURE
})