Users, permissions, and operations

Android integration

ImLoginReq req = new ImLoginReq();

req.user.userId = userId;
// Pass through additional business information.
Map<String, Object> data = new HashMap<>();
data.put("level", "high");
req.user.userExtension = App.getGson().toJson(data).toString();

req.userAuth = new ImAuth(nonce,  timestamp, role, app_token);
AliVCIMEngine.instance().login(req, new ImSdkCallback());

iOS integration

Login requires authentication information that you obtain from the server-side. This information includes the timestamp, nonce, and token values.

AliVCIMUser *user = [AliVCIMUser new];
user.userId = @"abc";  // The ID of the user who logs on to the app. The ID can be up to 64 characters long and can contain only letters, digits, and hyphens (-).
user.userExtension = @"{}"; // User extension information, such as profile picture and nickname, encapsulated as a JSON string.
AliVCIMAuthToken *auth = [AliVCIMAuthToken new];
auth.timestamp = 122222; // The timestamp value returned by the server.
auth.nonce = @"xxx";     // The nonce value returned by the server.
auth.role = @"admin";    // The admin role, which can create or shut down groups. If not needed, leave this empty.
auth.token = @"xxx";     // The token value returned by the server.
AliVCIMLoginReq *req = [AliVCIMLoginReq new];
req.currentUser = user;
req.authToken = auth;
[[AliVCIMEngine sharedEngine] login:req completed:^(NSError * _Nullable error) {
    NSLog(@"API - login result: %@", error ? error.description : @"success");
    if (!error) {
        // Logon is successful.
    }
}];

Web integration

Login requires authentication information. Before you log in, ensure that the prerequisites are met and that you have obtained the authentication information from the server-side. This information includes the timestamp, nonce, and token values.

try {  
     // Make sure that the asynchronous init operation is successful before you perform this operation.
    await engine.login({
      user: {
        userId: 'abc',       // The ID of the user logging on to the current app.
        userExtension: '{}', // User extension information, such as profile picture and nickname, encapsulated as a JSON string.
      },
      userAuth: {
        timestamp: 22123123, // The timestamp value returned by the server.
        nonce: 'nonce',      // The nonce value returned by the server.
        role: 'admin',       // The admin role. Set to empty if not needed.
        token: 'xxx'         // The token value returned by the server.
      },
    });
 } catch (error) {
    // 304: Already logged on. 400: Invalid parameter. 403: Authentication failed during logon.
    console.log(`login Fail: code:${error.code}, message: ${error.msg}`);
}

WeChat mini program integration

Login requires authentication information. Before you log in, ensure that the prerequisites are met and that you have obtained the authentication information from the server-side. This information includes the timestamp, nonce, and token values.

try {  
    // Make sure the asynchronous init operation is successful before you perform this operation.
    await engine.login({
      user: {
        userId: 'abc',       // The ID of the user who logs on to the current application.
        userExtension: '{}', // User extension information, such as the profile picture and nickname, encapsulated as a JSON string.
      },
      userAuth: {
        timestamp: 22123123, // The timestamp value returned by the server.
        nonce: 'nonce',      // The nonce value returned by the server.
        role: 'admin',       // The admin role. If this role is not needed, you can leave this empty.
        token: 'xxx'         // The token value returned by the server.
      },
    });
} catch (error) {
    // 304: Already logged on. 400: Invalid parameters. 403: Authentication failed during logon.
    console.log(`login Fail: code:${error.code}, message: ${error.msg}`);
}