【導讀】億美軟通短信平臺。版本號修改批準人修改人安裝日期簽收人。北京億美軟通科技有限公司。地址：北京市朝陽區(qū)光華路4號東方梅地亞中心C座20層。電話：010-58750575傳真：010-58750500. 售前咨詢：400-810-7255售后服務：400-779-7255

　　

【正文】 rcCharset 短信內(nèi)容 的 編碼方式 （可為空） ? 演示代碼 public void testsSendScheduledSMS(){ try { Client sdkclient=new Client(3SDKEMS0130AAAAA,123456)。 int a=(new String[] {13812341234}, 測試內(nèi)容 , 20210101101010,”123456”,”gbk”)。 (短信發(fā)送結(jié)果 :+a)。 } catch (Exception e) { ()。 } } ? 返回值 返回值 描述 0 短信發(fā)送成功 17 發(fā)送信息失敗 22/27 頁 18 發(fā)送定時信息失敗 ，一般用戶是定時格式不規(guī)范所致 101 客戶端網(wǎng)絡故障 305 服務器端返回錯誤，錯誤的返回值（返回值不是數(shù)字字符串） 307 目標電話號碼不符合規(guī)則，電話號碼必須是以 0、 1 開頭 997 平臺返回找不到超時的短信，該信息是否成功無法確定 998 由于客戶端網(wǎng)絡問題導致信息發(fā)送超 時 ，該信息是否成功 下發(fā) 無法確定 接收短信 ? 功能介紹 從 EUCP 平臺接收手機用戶上行的短信， 返回上行短信 ，該 list 的每個元素為一個 MO，如果獲取的結(jié)果為 null 則說明平臺暫時還沒有獲取到上行信息供客戶查 詢。 接收短信的方法需要申請才可以使用。 ? 函數(shù)聲明 public List getMOEx() throws Exception ? 返回值 返回結(jié)果 說明 ListMO 接收短信集合 ，集合中的值是 類型為 MO 的對象 ，該對象的數(shù)據(jù)結(jié)構(gòu)請 參見第二部分 數(shù) 據(jù)結(jié)構(gòu) ? 代碼演示 public void testGetMO(){ try { Client sdkclient=new Client(0SDKEMY0130AAAAA,123456)。 List a=()。 MO m=(MO)().next()。 (上行短信數(shù)量 :+())。 (上行短信內(nèi)容 :+())。 (上行通道號碼 :+())。 } catch (Exception e) { ()。 } } ? 演示結(jié)果 SDKServer:/ connected ! method:THREADGROUP:收發(fā)服務線程啟動 method:THREADGROUP:未發(fā)送超時監(jiān)控啟動 上行短信數(shù)量 :1 上行短信內(nèi)容 :測試 23/27 頁 上行通道號碼 :059180001003 修改密碼 ? 功能介紹 修改序列號的密碼 ? 函數(shù)聲明 public int serialPwdUpd(String serialPwd, String serialPwdNew) ? 參數(shù)詳解 參數(shù)名稱 說明 serialPwd 舊密碼 serialPwdNew 新密碼 ， 6 位，必須是數(shù)字字符串，必須輸入 ? 代碼演示 public void testSerialPwdUpd(){ try { Client sdkclient=new Client(3SDKEMS0130AAAAA,123456)。 int a=(123456, 654321)。 (短信發(fā)送結(jié)果 :+a)。 } catch (Exception e) { ()。 } } ? 演示結(jié)果 SDKServer:/ connected ! method:THREADGROUP:收發(fā)服務線程啟動 method:THREADGROUP:未發(fā)送超時監(jiān)控啟動 短信發(fā)送結(jié)果 :0 ? 返回值 返回值 描述 0 密碼修改成功 1 新密碼長度不能大于 6 101 客戶端網(wǎng)絡故障 305 服務器端返回錯誤數(shù)據(jù)，返回的數(shù)據(jù)必須是數(shù)字 308 新密碼不是數(shù)字，必須是數(shù)字 999 操作頻繁 24/27 頁 4 配置及環(huán)境要求 配置日志信息 客戶 端 開發(fā)包 默認采用 log4j 包 作為 日志工具 . ? 用戶沒有采用 Log4j 工具情況下 用戶在默認情況下無需手動配置 ,SDK 客戶端會自動運行日志工具 ,進行日志管理 . 日志目錄在項目目錄下的 sdklog 文件夾下 如發(fā)現(xiàn)異常請參考 常見問題 用戶也可根據(jù)自己不同的環(huán)境進行修改或刪除 配置文件 默認包含日志配置文件 ? 用戶自有 Log4j 工具情況 用戶 如已經(jīng)對 Log4j 進行管理 ,可不用理睬客戶端默認的 log4j 配置文件或?qū)⑴渲梦募?刪除 目前 sdk 客戶端采用默認的 debug , info , warn , error 級別 查看日志 日志文件 默認 保存在項目 下的 sdklog 文件夾內(nèi) , 包含日志文件為 , , , 分別記錄四個級別 以上 的日志信息 客戶端配置 客戶端為了滿足不同環(huán)境的不同用戶都能正常使用 ,采用的配置文件的方式 . 配置文件在 以下將對配置文件進行詳細說明 ? 其他默認編碼格式 CHARSETCODE 客戶端自有配置 ,用戶可不修改 默認 (GBK) ? 到發(fā)送緩存前的編碼格式 BYTECODE SDK 客戶端進行短信發(fā)送前的數(shù)據(jù)編碼格式 ,如客戶發(fā)送亂碼短信可由此進行修改 默認 (GBK) ? 服務器默認地址 SERVERADDR SDK 服務器的 ip 地址 ,SDK 客戶端啟動時將此 IP 作為 SDK 服務器地址 默認 () ? 服務器默認端口 SERVERPORT SDK 服務器的連接端口 .默認 (80) ? 數(shù)據(jù)超時時間 ClearTimeoutDateTime 暫時沒用 ? 發(fā)送 緩存 大小 SENDBUFFER SDK 客戶端的發(fā)送緩存和接收緩存 的初始化大小 , 客戶可根據(jù)自己的硬件環(huán)境進行修改 ,默認 (1048576) 單位 字節(jié) . 數(shù)值越大發(fā)送隊列的 承載性越強 ,能對 網(wǎng)絡質(zhì)量不好 時 ,會有更好的緩沖能力 . 25/27 頁 ? 接收緩存大小 RECEIVEBUFFER 默認初始化 （ 1048576）單位字節(jié) ? 最大緩存 MAXBUFFERSIZE 默認 (1048576) 單位 字節(jié) . 請將最大緩存調(diào)整和初始化緩存相同即可 ,目前未使用 ? 最小緩存 MINBUFFERSIZE 暫時沒用 ? 等待發(fā)送 隊列時間 WAITBUFFERTIME 暫時沒用 ? 等待短信響應時間 WAITRESPONSETIME 客戶端發(fā)送后 等待響應 超時 時間設定 . 默認 (10000) 單位 毫秒 通常當 網(wǎng)絡質(zhì)量出現(xiàn)問題 時會 涉及到此配置 .請根據(jù)網(wǎng)絡狀況將超時時間調(diào)長 . ? 短信收發(fā)頻率 SENDRECEIVESPEED SDK 客戶端采用 java 的 nio 包非阻塞網(wǎng)絡通信機制 ,次為短信收發(fā)器的收發(fā)頻率設定 默認 (10) 單位 毫秒 每隔這段時間才查看是否有收發(fā)數(shù)據(jù) ,短信收發(fā)量少可設定為 1001000 (毫秒 ) 為外界提供服務收發(fā)量大可設 定為 10100 (毫秒 ) ? 超時斷開連接時間 STOPHEARDTIME 當超過此時間沒有短信發(fā)送時 ,SDK 客戶端會自動斷開連接釋放網(wǎng)絡資源 , 當重新發(fā)送短信時客戶端會 自動 重新進行網(wǎng)絡連接 默認 (5) 單位分鐘 ? 短信發(fā)送超時情況下獲取下行短信狀態(tài)報告次數(shù) MTTIMES 默認為 6 次 ? 設置下行短信發(fā)送頻率 (毫秒 ) MTFREQUENCY 默認是 5000（毫秒） ? 收發(fā)線程測試連接次數(shù) （ TESTCONECTTIMES） 默認 5 次 ? 收發(fā)線程每次測試連接時間間隔 (單位秒 ) 默認 5 秒 Java 環(huán)境要求 需要 以上 運行環(huán)境 ，如果需要支持低版本的 jdk 則需要與我們客服取得聯(lián)系 5 開發(fā)建議 準備工作 合作伙伴必須通過億美軟通或是億美軟通代理商，取得 SDK 開發(fā)包和相關(guān)文檔，取得供由本 SDK使用的序列號及密碼，這些參數(shù)將用于服務注冊及短信發(fā)送。 26/27 頁 網(wǎng)絡測試 在調(diào)用 SDK 過程中出現(xiàn)網(wǎng)絡故障錯誤時，可通過以下指令測試 是否可正常連接 EUCP 平臺：tel 80 開發(fā)建議 ? 獲取開發(fā)包及 相關(guān)說明文檔之后，可先看一下說明文檔，之后運 行開發(fā)包中的示例 進行初步的試用。 ? 調(diào)用 SDK 各接口時，需參考 SDK 使用說明文檔 對接口返回值做相應的處理。 項目 檢查 ? 檢查 我們的項目中 是否有 日志 配置 文件 ，如果沒有那么檢查我們的，請根據(jù)自己的開發(fā)環(huán)境重新修改日志輸入路徑 ，如果有那么我們的默認配置文件可以不用關(guān)心 6 常見問題 解答 系統(tǒng)找不到指定的路徑 系統(tǒng)找不到指定的路徑 如下 : : sdklog\ (系統(tǒng)找不到指 定的路徑 .) 解釋 : Log4j的默認日志路徑為 sdklog/ 用戶可修改 客戶端 jar包中的 Log4j配置文件 指定日志輸出位置 如 :d:/sdklog/ 或在 項目目錄下添加 sdklog文件夾 如果是 WEB項目請在應用服務器的程序同目錄建 sdklog文件夾。 關(guān)于 序列號優(yōu)先級 請確認貴公司在億美軟通申請的序列號的優(yōu)先級，該優(yōu)先級為 15的數(shù)字，一般為 3，優(yōu)先級越高則短信越優(yōu)先處理，在發(fā)送高峰期將會 得到優(yōu)先處理，一般 5為類似 vip會員級別，具體級別定義請與億美運營部了解。如果貴公司所申請序列號級別不高而在高峰期有一批數(shù)量不大的短信息需要急著發(fā)送出去，可以聯(lián)系億美運營部，申請臨時調(diào)高優(yōu)先級優(yōu)先發(fā)送，該優(yōu)先級將最長 24 小時內(nèi)有效。同理若需要申請永久變更優(yōu)先級在無人工干預下，變更的優(yōu)先級也會在最長 24小時后生效。（億美服務器會在每日 0點 3點之間重新刷新序列號優(yōu)先級集合） 27/27 頁 關(guān)于短信優(yōu)先級 除了序列號優(yōu)先級，用戶應用程序可以自己定義短消息的優(yōu)先級，對于同一個序列號，短消息優(yōu)先級越高越優(yōu)先處理，可以選擇的級別為 15的數(shù)字，如果輸入大于 5的數(shù)字，則通訊程序會自動將其改變?yōu)?5. 余額不足時短信發(fā)送 如果出現(xiàn)余額不足仍然有可能提交成功，但數(shù)據(jù)經(jīng)過億美業(yè)務引擎時將被攔截而不能到達手機終端。之所以會出現(xiàn)此情況在于億美 sdk平臺考慮到執(zhí)行效率問題對零余額注冊號集合的更新載入有5分鐘的延時。在這 5分鐘內(nèi)如果賬戶余額不足，通訊過程將不攔截短信而是交給業(yè)務引擎攔截，5 分鐘后通訊引擎被告知攔截后則會通知客戶端余額不足。同理，在充值完成之后也需要等待最多5分鐘時間再發(fā)送短信。 客戶網(wǎng)絡環(huán)境條件 用戶網(wǎng)絡環(huán)境不穩(wěn)定的情況下 ,可修改響應 的配置 .請全文搜索 網(wǎng)絡質(zhì)量 異常 處理 ? FullSendBufferException 發(fā)送隊列或接受隊列滿 ,通常為發(fā)送隊列滿 ,當網(wǎng)絡 通訊出現(xiàn)問題 時 ,發(fā)送隊列數(shù)據(jù)未能及時發(fā)送出去 ,造成發(fā)送隊列滿 ,新的發(fā)送數(shù)據(jù)在進 入 發(fā)送隊列時 ,會拋出此異常 提示 ,返回結(jié)果信息為 306,此時不建議重發(fā) ,應檢查網(wǎng)絡狀況 如果 網(wǎng)絡正常 ,以上原因是因為發(fā)送量大造成 的 則 可修改 中的 配置文件 中的屬性 SENDBUFFER=1048576(字節(jié) ) 緩存大小 ,將此值調(diào)大 增加緩存大小 SENDRECEIVESPEED=10(毫秒 ) 短信收發(fā)頻率 ,將此值調(diào)小 加快短信收發(fā)頻率 (如果不是頻繁的出現(xiàn)此異常則不用理會 ,連續(xù)兩天都出現(xiàn)此異常視為頻繁 ) ? ErrorMobilesException 發(fā)送短信目標號碼不符合規(guī)則 ,目標號碼應為 11 位長度 手機號碼 無法連接到服務器 軟件序列號和密碼正確，關(guān)鍵字也正確就是沒辦法連接到服務器，這種情況下有確定自己的余額是否為 0，一旦序列號余額為 0，序列好就進入我們設定的黑名單，請與我們客戶聯(lián)系，充值并取消黑名單