### **設置服務器認證密碼** INT SetServerAuthPass(STRING Password); 功能：設置服務器連接認證密碼，確保SDK能正常連接到服務器。 返回值：0表示成功，否則為出錯代碼 參數： lpPassword 認證密碼（大小寫敏感）； 備注： 為了防止未授權SDK連接服務器，在服務器配置文件（AnyChatCoreServer.ini）中可設置“SDKAuthPass”，如果該配置項被設置，當SDK連接服務器時，會將該方法所傳入的密碼加密后傳輸到服務器，服務器再比較是否合法，如果密碼不正確，則連接將被斷開。如果該配置項未被設置（配置文件默認），則無論該方法是否被調用，SDK均可正常連接到服務器。 ### **連接服務器** INT Connect(STRING ServerAddr, INT Port); 功能：用于與服務器建立連接。 返回值：0表示成功，否則為出錯代碼 參數： lpServerAddr 服務器IP地址，或是網站域名（URL）地址； dwPort 服務端口號（默認為8906） 備注： 返回值為0并不表示連接服務器成功，僅表示SDK已成功收到連接服務器的指令，如果連接成功，或是失敗，都將會通過相應的接口通知上層應用，這里是一個異步的過程。 ### **登錄系統** INT Login(STRING UserName, STRING Password) 功能：登錄服務器，請求身份認證。 返回值：0表示成功，否則為出錯代碼 參數： lpUserName 注冊用戶名； lpPassword 登錄密碼（為空表示游客）； 備注： 該方法可以連接系統之后立即調用，而不用關心連接系統是否成功，當SDK連接系統成功之后，如果之前調用過該方法，則SDK將會自動向服務器發出登錄系統的申請。 返回值為0并不表示登錄服務器成功，僅表示SDK已成功收到登錄服務器的指令，如果登錄成功，或是失敗，都將會通過相應的接口通知上層應用，這里是一個異步的過程。 如果服務器配置了“SDK Filter Plus”插件，則客戶端調用該方法后，將會觸發其API接口：BRFP_VerifyUser，用戶名、密碼參數將會作為參數傳遞給該API函數，由“SDK Filter Plus”完成用戶的身份驗證工作，服務器根據該API接口的返回值來判定是否通過身份驗證，詳細信息可參考文檔《AnyChat SDK Filter Plus開發指南》。 如果在服務器端使用“AnyChat Server SDK”開發了業務層服務器，則客戶端調用該方法后，將會觸發業務層服務器的回調函數“BRAS_VerifyUser_CallBack”，由業務層服務器完成用戶的身份驗證工作，服務器根據回調函數的返回值來判定是否通過身份驗證，詳細信息可參考文檔《AnyChat Server SDK 開發指南》。 LoginEx(STRING lpNickName,INT dwUserId, STRING lpStrUserId, STRING lpStrAppId, DWORD dwTimeStamp, STRING lpSigStr, STRING lpStrParam) 功能： 登錄云平臺的接口，用戶進行簽名后調用此接口登錄到云平臺； 參數： lpNickName 字符串值，用戶顯示名稱 dwUserId 整形值，用戶Id值，如果應用沒有此參數，則傳入-1 lpStrUserId 字符串值，用戶編號，如果dwUserId參數有值，則此參數值可為傳空字符串；如果dwUserId為-1，則需要傳此參數值 dwTimeStamp 整型值，簽名的時間戳，由簽名工具返回 lpStrAppId 字符串值，在集群版本、視頻云平臺申請的應用Id lpSigStr 字符串值，使用應用的公鑰和私鑰進行簽名后生成的簽名字符串 lpStrParam 字符串值，預留參數，傳空字符串 返回值：0表示成功，否則為出錯代碼； 說明： 此接口用于用戶在自有的或第三方的身份驗證系統驗證之后，根據獲取的應用公鑰和設置的私鑰數據，再調用AnyChat提供的或自己編寫的身份簽名工具對用戶進行身份簽名。簽名后再調用此接口進行登陸；通過該接口后則不需要再由AnyChat業務服務器進行身份驗證了。 如果在系統或應用中設置了允許用戶以游客身份進行登陸，則該接口也可以不用驗證用戶身份簽名，允許用戶登錄系統。