Wireless Telephony Application Interface WTAI, Version08Sep2001

1
Wireless Telephony Application Interface(WTAI,
Version-08-Sep-2001)

• Felhasznált források
• WAP-286-WTAI-20010908-a

2
Incoming Call States
3
Outgoing Call States
4
Voice Call Handle

• A handle is associated with each voice call.
• The call handle is a unique identifier for the
  call. WTAI functions that operate on voice calls
  require this call handle as an input parameter
  (e.g., WTAVoiceCall.accept) or return a call
  handle when successful (e.g., WTAVoiceCall.setup).
  
• A WTA service should keep track of the handles
  for its calls in order to control those calls
  however, it should not inspect nor manipulate the
  call handle in any way.

5
Voice Call Modes

• Authors must indicate the coupling between an
  established voice call and the current WTA
  context using the mode parameter of the setup()
  or accept() functions. (See WTA.)
• The mode parameter indicates if the established
  voice call shold be dropped or kept when the WTA
  context is terminated.

6
Voice Call Information

• number
• status
• 1 call pending, 2initiating call, 3waiting for
  ringing, 4waiting for answer, 5in call, 6end
• mode
• falsedrop, truekeep
• name
• duration

7
Incoming, Outgoing Message
8
Network Message Handle

• A handle is associated with each network message.
  The message handle is a unique identifier for the
  message. WTAI functions that operate on network
  messages require this message handle as an input
  parameter (e.g., WTANetText.getFieldValue) or
  return a message handle when successful (e.g.,
  WTANetText.send).
• A WTA service should keep track of the handles
  for its messages in order to track those
  messages however, it should not inspect nor
  manipulate the message handle in any way.

9
Network Message Information

• text
• tstamp
• address
• status
• 1 unsent, 2 received, 3 end
• read
• tstamp_off
• tstamp_device

10
Phonebook Information

• number
• name

11
Call Log Model

• Dialled Call Log
• Missed Call Log
• Received Call Log

12
Call Log Entry Information

• number
• tstamp
• explanation

13
WTAI Libraries

• Network Common WTAI
• WTAVoiceCall, WTANetText, WTAPhoneBook,
  WTACallLog, WTAMisc
• Network Specific WTAI
• WTAGSM, WTAANSI136, WTAIS95
• Public WTAI
• WTAPublic

14
WTAI URI Scheme

• wtai//ltlibrarygt/ltfunctiongt ( ltparametergt) !
  ltresultgt
• ltlibrarygt Name that identifies the type of
  function, i.e. WTAPublic uses the library name
  wp.
• ltfunctiongt Function identifier within specific
  library. An example is mc for the function
  makeCall residing in the library WTAPublic.
• ltparametergt Zero or more parameters to be sent to
  the function. Delimiter between subsequent
  parameters MUST be a semicolon .
• ltresultgt Start of the result data section is
  indicated by an exclamation mark !. Result an
  optional name of the variable that will be set in
  the WTA user-agent context as a result of the
  function invocation.

15
Public WTAI

• WMLScript functions
• WTAPublic.makeCall(number)
• WTAPublic.sendDTMF(dtmf)
• WTAPublic.addPBEntry(number,name)
• URI functions
• wtai//wp/mcnumber!result
• wtai//wp/sddtmf!result
• wtai//wp/apnumbername!result

16
Network Common WTAI Voice Calls

• WMLScript Functions
• WTAVoiceCall.setup(number,mode)
• WTAVoiceCall.accept(callHandle,mode)
• WTAVoiceCall.release(callHandle)
• WTAVoiceCall.sendDTMF(callHandle,dtmf)
• WTAVoiceCall.callStatus(callHandle,field)
• WTAVoiceCall.list(returnFirst)

17
Network Common WTAINetwork Messages

• WMLScript Functions
• WTANetText.send(address,text)
• WTANetText.list(returnFirst,messageType)
• WTANetText.remove(msgHandle)
• WTANetText.getFieldValue(msgHandle,field)
• WTANetText.markAsRead(msgHandle)

18
Network Common WTAIPhonebook Entries

• WMLScript Functions
• WTAPhoneBook.write(index,number,name)
• WTAPhoneBook.search(field,value)
• WTAPhoneBook.remove(index)
• WTAPhoneBook.getFieldValue(index,field)
• WTAPhoneBook.change(index,field,newValue)

19
Network Common WTAIPhonebook Entries

• WMLScript Functions
• WTACallLog.dialled(returnFirst)
• WTACallLog.missed(returnFirst)
• WTACallLog.received(returnFirst)
• WTACallLog.getFieldValue(logHandle,field)

20
Network Common WTAIMiscellaneous

• WMLScript Functions
• WTAMisc.setIndicator(type,newState)
• WTAMisc.endContext()
• WTAMisc.getProtection()
• WTAMisc.setProtection(mode)
• URI Functions
• wtai//ms/ec

21
(No Transcript)
22
(No Transcript)
23
(No Transcript)