javapublic void addChatroomClientListener(V2NIMChatroomClientListener listener) 

objective-c- (void)addChatroomClientListener:(id<V2NIMChatroomClientListener>)listener;

cppvirtual void addChatroomClientListener(V2NIMChatroomClientListener listener) = 0;

javachatroomClient.addChatroomClientListener(new V2NIMChatroomClientListener() {
    @Override
    public void onChatroomStatus(V2NIMChatroomStatus status, V2NIMError error) {
        
    }

    @Override
    public void onChatroomEntered() {

    }

    @Override
    public void onChatroomExited(V2NIMError error) {

    }

    @Override
    public void onChatroomKicked(V2NIMChatroomKickedInfo kickedInfo) {

    }
});

objective-c@interface ClientListener : NSObject <V2NIMChatroomClientListener>
- (void)addToClient:(NSInteger)clientId;
@end

@implementation ClientListener
- (void)addToClient:(NSInteger)clientId
{
    V2NIMChatroomClient *instance = [V2NIMChatroomClient getInstance:clientId];
    [instance addChatroomClientListener:self];
}

- (void)onChatroomStatus:(V2NIMChatroomStatus)status
                   error:(nullable V2NIMError *)error
{

}
- (void)onChatroomEntered
{

}

- (void)onChatroomExited:(nullable V2NIMError *)error
{

}

- (void)onChatroomKicked:(V2NIMChatroomKickedInfo *)kickedInfo
{

}
@end

cppV2NIMChatroomClientListener listener;
listener.onChatroomStatus = [](V2NIMChatroomStatus status, nstd::optional<V2NIMError> error) {
    // handle chatroom status
};
listener.onChatroomEntered = []() {
    // handle chatroom entered
};
listener.onChatroomExited = [](nstd::optional<V2NIMError> error) {
   // handle chatroom exited
};
listener.onChatroomKicked = [](V2NIMChatroomKickedInfo kickedInfo) {
    // handle chatroom kicked
};
chatroomClient.addChatroomClientListener(listener);

javapublic void removeChatroomClientListener(V2NIMChatroomClientListener listener)

objective-c- (void)removeChatroomClientListener:(id<V2NIMChatroomClientListener>)listener;

cppvirtual void removeChatroomClientListener(V2NIMChatroomClientListener listener) = 0;

javachatroomClient.removeChatroomClientListener(chatroomClientListener);

objective-c@interface ClientListener : NSObject <V2NIMChatroomClientListener>
- (void)addToClient:(NSInteger)clientId;
- (void)removeFromClient:(NSInteger)clientId;
@end

@implementation ClientListener
- (void)addToClient:(NSInteger)clientId
{
    V2NIMChatroomClient *instance = [V2NIMChatroomClient getInstance:clientId];
    [instance addChatroomClientListener:self];
}

- (void)removeFromClient:(NSInteger)clientId
{
    V2NIMChatroomClient *instance = [V2NIMChatroomClient getInstance:clientId];
    [instance removeChatroomClientListener:self];
}

- (void)onChatroomStatus:(V2NIMChatroomStatus)status
                   error:(nullable V2NIMError *)error
{

}
- (void)onChatroomEntered
{

}

- (void)onChatroomExited:(nullable V2NIMError *)error
{

}

- (void)onChatroomKicked:(V2NIMChatroomKickedInfo *)kickedInfo
{

}
@end

cppV2NIMChatroomClientListener listener;
// ...
chatroomClient.addChatroomClientListener(listener);
// ...
chatroomClient.removeChatroomClientListener(listener);

typescriptexport interface NIMEBaseServiceInterface<I extends NIMEBaseListener> {
  /**
   * 继承自 EventEmitter3 的监听事件方法。
   */
  on<T extends keyof I>(eventName: T, fn: (...args: I[T]) => void): void;
  /**
   * 继承自 EventEmitter3 的监听事件方法。
   */
  once<T extends keyof I>(eventName: T, fn: (...args: I[T]) => void): void;
}

typescriptexport interface NIMEBaseServiceInterface<I extends NIMEBaseListener> {
  /**
   * 继承自 eventEmitter3 的监听事件方法
   */
  on<T extends keyof I>(eventName: T, fn: (...args: I[T]) => void): void
  /**
   * 继承自 eventEmitter3 的监听事件方法
   */
  once<T extends keyof I>(eventName: T, fn: (...args: I[T]) => void): void
}

typescriptchatroom.on("onChatroomStatus", function (status: V2NIMChatroomStatus, err?: V2NIMError) {})
chatroom.on("onChatroomEntered", function () {})
chatroom.on("onChatroomExited", function (err?: V2NIMError) {})
chatroom.on("onChatroomKicked", function (kickedInfo: V2NIMChatroomKickedInfo) {})

typescriptconst chatroom = this.getInstance(instanceId)
chatroom.on("onChatroomStatus",  (status: V2NIMChatroomStatus, err?: V2NIMError) => {
})
chatroom.on("onChatroomEntered",  ()=> {
})
chatroom.on("onChatroomExited", (err?: V2NIMError) => {
})
chatroom.on("onChatroomKicked", (kickedInfo: V2NIMChatroomKickedInfo)=> {
})

typescriptexport interface NIMEBaseServiceInterface<I extends NIMEBaseListener> {
  /**
   * 继承自 EventEmitter3 的取消监听方法。
   */
  off<T extends keyof I>(eventName: T, fn: (...args: I[T]) => void): void;
  /**
   * 继承自 EventEmitter3 的移除事件方法。
   */
  removeAllListeners<T extends keyof I>(eventName?: T): void;
}

typescriptexport interface NIMEBaseServiceInterface<I extends NIMEBaseListener> {
  /**
   * 继承自 eventEmitter3 的取消监听方法
   */
  off<T extends keyof I>(eventName: T, fn: (...args: I[T]) => void): void
  /**
   * 继承自 eventEmitter3 的移除事件方法
   */
  removeAllListeners<T extends keyof I>(eventName?: T): void
}

typescriptchatroom.off("onChatroomStatus", function (status: V2NIMChatroomStatus, err?: V2NIMError) {})
chatroom.off("onChatroomEntered", function () {})
chatroom.off("onChatroomExited", function (err?: V2NIMError) {})
chatroom.off("onChatroomKicked", function (kickedInfo: V2NIMChatroomKickedInfo) {})

typescriptchatroom.off("onChatroomStatus", function (status: V2NIMChatroomStatus, err?: V2NIMError) {})
chatroom.off("onChatroomEntered", function () {})
chatroom.off("onChatroomExited", function (err?: V2NIMError) {})
chatroom.off("onChatroomKicked", function (kickedInfo: V2NIMChatroomKickedInfo) {})

javapublic synchronized static V2NIMChatroomClient newInstance()

objective-c+ (instancetype)newInstance;

cppstatic nstd::shared_ptr<V2NIMChatroomClient> newInstance();

typescriptstatic newInstance(initParams: V2NIMChatroomInitParams): V2NIMChatroomClient

typescriptstatic newInstance(context:common.Context, initParams: V2NIMChatroomInitParams): V2NIMChatroomClient

javaV2NIMChatroomClient chatroomClient = V2NIMChatroomClient.newInstance();

objective-cV2NIMChatroomClient *chatroomClient = [V2NIMChatroomClient newInstance];

cppauto chatroomClient = V2NIMChatroomClient::newInstance();
if (!chatroomClient) {
    // create instance failed
    // ...
    return;
}
auto instanceId = chatroomClient->getInstanceId();
// save instanceId to cache
// ...

typescriptconst chatroom = V2NIMChatroomClient.newInstance(
    {
        appkey: 'YOUR_APPKEY'
    }
)

typescriptconst context: common.Context = getContext(this).getApplicationContext()
const chatroom = V2NIMChatroomClient.newInstance(context，
    {
        appkey: 'YOUR_APPKEY'
    }
)

javapublic synchronized static void destroyInstance(int instanceId)

objective-c+ (void)destroyInstance:(NSInteger)instanceId;

cppstatic void destroyInstance(uint32_t instanceId);

typescriptstatic destroyInstance(instanceId: number): void

typescriptstatic destroyInstance(instanceId: number): void

javaV2NIMChatroomClient.destroyInstance(instanceId);

objective-c[V2NIMChatroomClient destroyInstance:instanceId];

cppuint32_t instanceId{0};
// get instanceId from cache
// ...
V2NIMChatroomClient::destroyInstance(instanceId);

typescriptV2NIMChatroomClient.destroyInstance(this.instanceId)

typescriptV2NIMChatroomClient.destroyInstance(this.instanceId)

javapublic synchronized static V2NIMChatroomClient getInstance(int instanceId)

objective-c+ (instancetype)getInstance:(NSInteger)instanceId;

cppstatic nstd::shared_ptr<V2NIMChatroomClient> getInstance(uint32_t instanceId);

typescriptstatic getInstance(instanceId?: number): V2NIMChatroomClient

typescriptstatic getInstance(instanceId: number): V2NIMChatroomClient

javaV2NIMChatroomClient chatroomClient = V2NIMChatroomClient.getInstance(roomClientId)

objective-cV2NIMChatroomClient *client = [V2NIMChatroomClient getInstance:roomClientId];

cppuint32_t instanceId{0};
// get instanceId from cache
// ...
auto chatroomClient = V2NIMChatroomClient::getInstance(instanceId);
if (!chatroomClient) {
    // instance not found
    // ...
    return;
}

typescriptconst chatroom = V2NIMChatroomClient.getInstance(instanceId)

typescriptconst chatroom = V2NIMChatroomClient.getInstance(instanceId)

javapublic synchronized static List<V2NIMChatroomClient> getInstanceList()

objective-c+ (NSArray<V2NIMChatroomClient *> *)getInstanceList;

cppstatic nstd::vector<nstd::shared_ptr<V2NIMChatroomClient>> getInstanceList();

typescriptstatic getInstanceList(): V2NIMChatroomClient[]

typescriptstatic getInstanceList(): V2NIMChatroomClient[]

javaList<V2NIMChatroomClient> chatroomClients = V2NIMChatroomClient.getInstanceList();

objective-cNSArray<V2NIMChatroomClient *> *clients = [V2NIMChatroomClient getInstanceList];

cppauto chatroomClients = V2NIMChatroomClient::getInstanceList();

typescriptconst chatroomArr = V2NIMChatroomClient.getInstanceList()

typescriptconst chatroomArr = V2NIMChatroomClient.getInstanceList()

javapublic synchronized static void destroyAll()

objective-c+ (void)destroyAll;

cppstatic void destroyAll();

typescriptstatic destroyAll(): void

typescriptstatic destroyAll(): void

javaV2NIMChatroomClient.destroyAll();

objective-c[V2NIMChatroomClient destroyAll];

cppV2NIMChatroomClient::destroyAll();

typescriptV2NIMChatroomClient.destroyAll()

typescriptV2NIMChatroomClient.destroyAll()

javapublic void enter(String roomId, V2NIMChatroomEnterParams enterParams, V2NIMSuccessCallback<V2NIMChatroomEnterResult> success, V2NIMFailureCallback failure)

objective-c- (void)enter:(NSString *)roomId
  enterParams:(V2NIMChatroomEnterParams *)enterParams
      success:(nullable V2NIMChatroomEnterResultCallback)success
      failure:(nullable V2NIMFailureCallback)failure;

cppvirtual void enter(nstd::string roomId,
    V2NIMChatroomEnterParams enterParams,
    V2NIMSuccessCallback<V2NIMChatroomEnterResult> success,
    V2NIMFailureCallback failure) = 0;

typescriptenter(roomId: string, enterParams: V2NIMChatroomEnterParams): Promise<V2NIMChatroomEnterResult>

typescriptenter(roomId: string, enterParams: V2NIMChatroomEnterParams): Promise<V2NIMChatroomEnterResult>

javaV2NIMChatroomLinkProvider chatroomLinkProvider = new V2NIMChatroomLinkProvider() {
    @Override
    public List<String> getLinkAddress(String roomId, String accountId) {
        return "聊天室 link 地址";
    }
};

V2NIMChatroomLoginOption loginOption = V2NIMChatroomLoginOption.V2NIMChatroomLoginOptionBuilder.builder()
// 按需设置
//                .withAuthType()
//                .withLoginExtensionProvider()
//                .withTokenProvider()
        .build();

V2NIMChatroomEnterParams enterParams = V2NIMChatroomEnterParams.V2NIMChatroomEnterParamsBuilder.builder(chatroomLinkProvider)
// 按需设置
//                .withAccountId()
//                .withAnonymousMode()
//                .withAntispamConfig()
//                .withLocationConfig()
//                .withLoginOption(loginOption)
//                .withNotificationExtension()
//                .withRoomAvatar()
//                .withRoomNick()
//                .withServerExtension()
//                .withTagConfig()
//                .withTimeout()
//                .withToken()
        .build();

V2NIMChatroomClient.newInstance().enter(roomId, enterParams,
        new V2NIMSuccessCallback<V2NIMChatroomEnterResult>() {
            @Override
            public void onSuccess(V2NIMChatroomEnterResult result) {

            }
        },
        new V2NIMFailureCallback() {
            @Override
            public void onFailure(V2NIMError error) {
                
            }
        });

objective-c// 配置 link 地址回调
@interface ChatroomLinkProvider : NSObject <V2NIMChatroomLinkProvider>
@end

@implementation ChatroomLinkProvider
- (nullable NSArray<NSString *> *)getLinkAddress:(NSString *)roomId accountId:(NSString *)accountId {
    return @[@"link0", @"link1"];
}
@end
// 进入聊天室
NSString *roomId = @"2024";

V2NIMChatroomLoginOption *loginOption = [[V2NIMChatroomLoginOption alloc] init];
//默认鉴权方式进入聊天室
loginOption.authType = V2NIM_LOGIN_AUTH_TYPE_DEFAULT;
V2NIMChatroomEnterParams *enterParams = [[V2NIMChatroomEnterParams alloc] init];
// 账号
enterParams.accountId = @"accountId";
// token
enterParams.token = @"token";
// 动态设置link地址
enterParams.linkProvider = [[ChatroomLinkProvider alloc] init];

[[V2NIMChatroomClient newInstance] enter:roomId
                             enterParams:enterParams
                                 success:^(V2NIMChatroomEnterResult *result)
                                 {
                                     //进入聊天室成功
                                 }
                                 failure:^(V2NIMError *error)
                                 {
                                     //进入聊天室失败
                                 }];

cppV2NIMChatroomEnterParams enterParams;
enterParams.accountId = "accountId";
enterParams.token = "token";
enterParams.roomNick = "nick";
enterParams.roomAvatar = "avatar";
enterParams.linkProvider = [](nstd::string roomId, nstd::string account) {
    nstd::vector<nstd::string> linkAddresses;
    // get link addresses
    // ...
    return linkAddresses;
};
enterParams.serverExtension = "server extension";
enterParams.notificationExtension = "notification extension";
chatroomClient.enter(
    "roomId",
    enterParams,
    [](V2NIMChatroomEnterResult result) {
        // enter succeeded
    },
    [](V2NIMError error) {
        // enter failed, handle error
    });

typescriptconst res = await instance.enter(roomId, {
    accountId: 'ACCID',
    token: 'TOKEN',
    roomNick: 'YOUR_NICK',
    roomAvatar: 'YOUR_IMG_URL',
    linkProvider: function() {
        return Promise.resolve(['chatweblink12.netease.im])
    }
});

typescriptconst client = this.getInstance(instanceId)
const enterParams: V2NIMChatroomEnterParams = {
  accountId: accountId,
  roomNick: roomNick,
  roomAvatar: roomAvatar,
  token: token,
  linkProvider: function() {
    return Promise.resolve(linkAddressArray)
  },
  serverExtension: serverExtension,
  notificationExtension: notificationExtension,
  tagConfig: {
    tags: tags,
    notifyTargetTags: notifyTargetTags
  },
  locationConfig: {
    distance: distance,
    locationInfo: {
      x: x,
      y: y,
      z: z
    }
  }
}

return await client.enter(roomId, enterParams)

无返回值

Promise<V2NIMChatroomEnterResult> 进入聊天室结果

• 请求成功，返回 V2NIMSuccessCallback 回调，包含 V2NIMChatroomEnterResult。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含聊天室相关错误码。

• 请求成功，返回 V2NIMChatroomEnterResultCallback 回调，可自定义设置；创建成功，返回 onTeamCreated 回调。
• 请求失败，返回 V2NIMFailuerCallback 回调，包含群组相关错误码。

无

javapublic void exit()

objective-c- (void)exit;

cppvirtual void exit() = 0;

typescriptexit(): void

typescriptexit(): void

javachatroomCore.exit();

objective-c[[V2NIMChatroomClient getInstance:instanceId] exit];

cppchatroomClient.exit();

typescriptchatroom.exit()

typescriptconst client = this.getInstance(instanceId)
client.exit()

javapublic V2NIMChatroomInfo getChatroomInfo()

objective-c- (V2NIMChatroomInfo *)getChatroomInfo;

cppvirtual V2NIMChatroomInfo getChatroomInfo() = 0;

typescriptgetChatroomInfo(): V2NIMChatroomInfo | null

typescriptgetChatroomInfo(): V2NIMChatroomInfo | null

javaV2NIMChatroomInfo chatroomInfo = chatroomClient.getChatroomInfo();

objective-c[[V2NIMChatroomClient getInstance:instanceId] getChatroomInfo];

cppauto chatroomInfo = chatroomClient.getChatroomInfo();

typescriptconst chatroomInfo = chatroom.getChatroomInfo()

typescriptconst client: V2NIMChatroomClient = this.getInstance(instanceId)
const ret = client.getChatroomInfo()

javapublic V2NIMChatroomService getChatroomService()

objective-c- (id<V2NIMChatroomService>)getChatroomService;

cppvirtual V2NIMChatroomService& getChatroomService() = 0;

typescriptpublic chatroomService: V2NIMChatroomService

javaV2NIMChatroomService chatroomService = chatroomClient.getChatroomService()

objective-c[[V2NIMChatroomClient getInstance:instanceId] getChatroomService];

cppauto& chatroomService = client.getChatroomService();

typescriptconst client: V2NIMChatroomClient = this.getInstance(instanceId)
const ret = client.chatroomService

javapublic V2NIMStorageService getStorageService()

objective-c- (id<V2NIMStorageService>)getStorageService;

cppvirtual V2NIMStorageService& getStorageService() = 0;

typescriptpublic storageService: V2NIMChatroomStorageService

javaV2NIMStorageService storageService = chatroomClient.getStorageService()

objective-c[[V2NIMChatroomClient getInstance:instanceId] getStorageService];

cppauto& storageService = client.getStorageService();

typescriptconst client: V2NIMChatroomClient = this.getInstance(instanceId)
const ret = client.storageService