### **可選函數：** 函數： BRAC_SetServerAuthPass(STRING lpPassword) 功能： 設置服務器連接認證密碼，確保SDK能正常連接到服務器。 參數： lpPassword 字符串值，表示認證密碼（大小寫敏感） 返回值：0表示成功，否則為出錯代碼 說明：為了防止未授權SDK連接服務器，在服務器配置文件（AnyChatCoreServer.ini）中可設置“SDKAuthPass”，如果該配置項被設置，當SDK連接服務器時，會將該方法所傳入的密碼加密后傳輸到服務器，服務器再比較是否合法，如果密碼不正確，則連接將被斷開。如果該配置項未被設置（配置文件默認），則無論該方法是否被調用，SDK均可正常連接到服務器。 ### **必要函數**： ### **連接服務器** 函數： BRAC_Connect(STRING lpServerAddr, INT dwPort) 功能： 用于與服務器建立連接 參數： lpServerAddr 字符串值，服務器IP地址或網站域名（URL）地址； dwPort 整形值，服務器端口號（默認端口號為：8906）； 返回值：0表示成功，否則為出錯代碼； 說明：返回值為0并不表示連接服務器成功，僅表示SDK已成功收到連接服務器的指令，如果連接成功，或是失敗，都將會通過相應的接口通知上層應用，這里是一個異步的過程。 `BRAC_Connect(GetID("ServerAddr").value, parseInt(GetID("ServerPort").value)); //連接服務器` 回調函數 ~~~ // 客戶端連接服務器，bSuccess表示是否連接成功，errorcode表示出錯代碼 function OnAnyChatConnect(bSuccess, errorcode) { } ~~~ ### **登錄系統** 函數： BRAC_Login(STRING lpUserName, STRING lpPassword, INT dwParam) 功能： 登錄服務器，請求身份驗證； 參數： lpUserName 字符串值，登錄用戶名 lpPassword 字符串值，登錄密碼 dwParam 整形值，備用參數（登錄時傳0） 返回值：0表示成功，否則為出錯代碼； 說明： 該方法可以連接系統之后立即調用，而不用關心連接系統是否成功，當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 開發指南》。 函數： BRAC_LoginEx(STRING lpNickName,INT dwUserId, STRING lpStrUserId, STRING lpAppId, DWORD dwTimeStamp,STRING lpSigStr, STRING lpStrParam) 功能： 登錄擴展接口，支持集群服務平臺、視頻云平臺應用簽名登錄。 參數： lpNickName 字符串值，用戶顯示名稱 dwUserId 整形值，用戶Id值，如果應用沒有此參數，則傳入-1 lpStrUserId 字符串值，用戶編號，如果dwUserId參數有值，則此參數值可為傳空字符串；如果dwUserId為-1，則需要傳此參數值 lpAppId 字符串值，在集群版本、視頻云平臺申請的應用Id dwTimeStamp 整形值，簽名的時間戳，由簽名工具返回 lpSigStr 字符串值，使用應用的公鑰和私鑰進行簽名后生成的簽名字符串，如何生成簽名請參見AnyChat視頻云平臺的開發指南 lpStrParam 字符串值，預留參數，傳空字符串 返回值：0表示成功，否則為出錯代碼； 說明： 此接口用于用戶在自有的或第三方的身份驗證系統驗證通過后，根據獲取的應用公鑰和設置的私鑰數據，再調用AnyChat提供的或自己編寫的身份簽名工具對用戶進行身份簽名。在應用簽名通過后再調用此接口進行登錄；通過該接口后則不需要再由AnyChat業務服務器進行身份驗證了。 如果在系統或應用中設置了允許用戶以游客的身份進行登錄，則該接口也可以不用驗證用戶身份簽名，允許用戶登錄系統。 回調函數 ~~~ // 客戶端登錄系統，dwUserId表示自己的用戶ID號，errorcode表示登錄結果：0 成功，否則為出錯代碼，參考出錯代碼定義 function OnAnyChatLoginSystem(dwUserId, errorcode) { } ~~~