HiNet企業簡訊 - COM元件使用說明

• 系統需求：Windows
  
  
• 元件註冊方法：(使用前必須先註冊)
  
  1. 確認系統為32或64位元並執行下列步驟：
  
  [32位元] 1. 將32位元HiAir.dll複製到Windows系統目錄中，如C:\Windows\System32\ 或 C:\WinNT\System32\ 。
  
  [32位元] 2. 於Windows開始->執行的視窗中，輸入指令 regsvr32 HiAir.dll路徑， 如regsvr32 C:\Windows\System32\HiAir.dll。
  
  [64位元] 1. 將64位元HiAir.dll複製到Windows系統目錄中，如C:\Windows\SysWOW64\。
  
  [64位元] 2. 於C:\Windows\SysWOW64\目錄中空白處->按住shift+右鍵->點選 "在這裡開啟PowerShell視窗"， 輸入指令 regsvr32 HiAir.dll。
  
  2. 出現註冊成功的畫面，如以下視窗，即代表元件註冊成功。
  
     
  
  3. 元件ProgID為HiAir.HiNetSMS，即為此元件之Object名稱。
  
  
• 元件函式說明：
  
  

  函式名稱	說明
  StartCon(ServerIP,ServerPort,UserID,Passwd)	建立hiAirV2伺服器連線
  SendMsg(MobileNum,Message)	傳送文字簡訊
  SendMsg_Reserve(MobileNum,Message,Send_Time)	預約傳送文字簡訊
  SendMsg_Expire(MobileNum,Message,Expire_Time)	傳送文字簡訊+重送截止時間
  SendMsg_Reserve_Expire(MobileNum,Message,Send_Time,Expire_Time)	預約傳送文字簡訊+重送截止時間
  SendMsg_WapPush(MobileNum,WapTitle,WapURL)	傳送Wappush(需額外申請)
  CancelMsg(MessageID)	取消預約文字簡訊傳送
  QueryMsg(MessageID)	查詢文字簡訊傳送結果
  QueryMsg_WapPush(MessageID)	查詢Wappush傳送結果
  Get_Message( )	取得系統回傳的訊息
  RecvMsg( )	接收手機回傳簡訊(一般用戶不提供)
  Get_Send_MSISDN( )	取得手機回覆者的門號(一般用戶不提供)
  EndCon( )	結束Socket To Air伺服器連線

  函式參數說明：

  參數名稱	參數型態	內容	說明
  ServerIP	字串(string)	Socket to Air伺服器IP	api.hiair.hinet.net
  ServerPort	字串(string)	Socket to Air伺服器Port	8000
  UserID	字串(string)	登入帳號	最長8個字元
  Passwd	字串(string)	登入密碼	最長8個字元
  MobileNum	字串(string)	手機號碼	國內門號為10個字元
  Message	字串(string)	簡訊內容	最長為159個字元
  Send_Time	字串(string)	預約傳送的時間	格式:YYMMDDHHMM00(12字元)
  Expire_Time	字串(string)	重送截止的時間	格式:0001~1400(4字元)單位:分鐘
  MessageID	字串(string)	系統回傳的訊息ID	簡訊傳送時，系統回傳的訊息ID
  WapMessage	字串(string)	WapPush標題	ex: HiNetWap網站
  WapURL	字串(string)	WapPush URL	ex: http://hiair.hinet.net?id=12345

  註1：YYMMDDHHMM00->年月日時分秒，秒必須為00。
            Ex : 021210110200 表示西元2002年12月10日11點02分
  註2：Expire_Time：簡訊重送的截止時間，預設值是24小時。
            Expire_Time="0030" 表示簡訊如果30分鐘內沒送成功，就不送了。
  　

  
  函式回傳值說明：

  1.	StartCon(ServerIP,ServerPort,UserID,Passwd)：回傳值型態為int
  	回傳值 內容 0  帳號/密碼檢查成功 1  密碼錯誤 2  帳號不存在 3  超過准許最大連線數 -1  Socket 連結失敗 -2  查server dns -> ip 錯誤 -3  Socket初始化錯誤 -4  Socket 傳送/接收資料錯誤 其他值  請參考軟體規格書
  2.	SendMsg(MobileNum,Message)：回傳值型態為int
  	回傳值 內容 0  訊息傳送成功 2  編碼格式錯誤 6  手機號碼格式 8  重送截止時間格式錯誤 9  預約傳送時間格式錯誤 11  系統暫時無法傳送訊息 -4  Socket 傳送/接收資料錯誤 其他值  請參考軟體規格書 註1：當回傳值=0，傳送成功，此時請用GetMessage取得系統回覆的MessageID，           以供查詢簡訊傳送結果用。 註2：SendMsg_Reserve( ),SendMsg_Expire( ),SendMsg_Reserve_Expire( )的回傳值           內容與SendMsg相同。
  3.	QueryMsg(MessageID)：回傳值型態為int
  	回傳值 內容 0  訊息已送達接收方 1  手機未開或在受訊範圍外 2  查詢系統無此MessageID資料 3  MessageID格式錯誤 4  已送到簡訊中心，尚未完成查詢 5  預約時間超過48小時 -4  Socket 傳送/接收資料錯誤 其他值  請參考軟體規格書
  4.	GetMessage：回傳值型態為string
  	GetMessage為執行某函式後的回傳值說明，對應資料如下： 　 對應函式 回傳值 GetMessage的內容 StartCon(..) 0  回傳內容連線成功訊息 非0  回傳內容連線失敗訊息說明 SendMsg(..) 0  回傳內容為20個字元的MessageID 非0  回傳內容為傳送錯誤訊息說明 QueryMsg(..) 0  回傳內容訊息已送達接收方與接收時間 非0  回傳內容為訊息目前狀態說明 RecvMsg(..) 0  回傳回覆端回覆的內容訊息 非0  回傳內容為訊息狀態說明 註：當SendMsg( )成功傳送訊息到Server，系統會回傳MessageID，需用         GetMessage取得MessageID
  5.	RecvMsg : 回傳值型態為int
  	回傳值 內容 0  有手機回傳簡訊 1  系統無手機回傳的簡訊 2  系統錯誤，請重試 -4  Socket 傳送/接收資料錯誤 註：當回傳值=0，表示系統有手機回傳的簡訊，此時請用Get_Message取得         手機回覆的內容，用Get_Send_MSISDN取得回覆者的手機號碼。
  6.	Get_Send_MSISDN：回傳值型態為string
  	回傳值為手機號碼 註：當執行RecvMsg取得手機回傳的簡訊時，需用Get_Send_MSISDN取得回傳        者的手機號碼。
  7.	EndCon()：無回傳值

  　

• 其他相關說明：
  
  1. StartCon( )成功建立連線後，才可使用SendMsg( )、QueryMsg( )和RecvMsg，傳送
      結束後，請記得使用EndCon( )結束連線。
  
  2. SendMsg( )將簡訊傳送到簡訊伺服器，如果成功(回傳值=0)，則系統會回傳一個
      MessageID，請用GetMessage( )取得此MessageID，之後可以根據此MessageID，
      使用QueryMsg( )查詢簡訊是否有成功傳送至GSM手機或呼叫器中。如果傳送不成
      功(回傳值!=0)，可以用GetMessage( )取得系統回覆的訊息說明。
  
  3. 執行RecvMsg( )接收回傳的簡訊，如果成功(回傳值=0)，請用GetMessage( )取得回傳的
      簡訊內容，用Get_Send_MSISDN( )取得回傳者的手機號碼。
  
  4. 如欲一次傳送多筆簡訊，請於StartCon( )成功建立連結後，多次執行SendMsg( )即可。
  
  5. 簡訊伺服器，同一帳號最多可同時建立五個Connection。