Android jChat用户手册.docx
- 文档编号:27591809
- 上传时间:2023-07-03
- 格式:DOCX
- 页数:19
- 大小:318.53KB
Android jChat用户手册.docx
《Android jChat用户手册.docx》由会员分享,可在线阅读,更多相关《Android jChat用户手册.docx(19页珍藏版)》请在冰豆网上搜索。
AndroidjChat用户手册
AndroidjChat1.3
UserGuide
Lastupdate:
26-January-2009
Authors:
DaniloGotta
StefanoSemeria
TizianaTrucco
MarcoUghetti
Contents
Introduction3
AndroidjChat1.3setup3
Settingthephonenumber3
CustomizingtheGPSlocationprovider3
LaunchingJADEmaincontainer5
UsingAndroidjChat1.36
ConnectingtoJADE6
KnowingjChat1.3tabs8
TheContacttab8
Themaptab9
Pickingcontacts10
Interactingwithcontacts11
SendinganSMStooneormorecontacts11
Callingacontact11
Startingachatsession12
Usingthestatusbartobrowsechatsessions12
Closingachatsession13
CompilingandsigningjChat15
FAQ16
LEGALINFORMATION17
TermsandConditionsofuse17
Limiteduse17
Disclaimer17
Informationfromyou17
LawandJurisdiction17
Introduction
jChatapplicationisanagentbasedIM-styleapplicationforAndroid,basedonJADE().
ItallowstheusertocommunicatewithanyothercontacthavingthesamesoftwarerunningandconnectedtothesameJADEplatform.UserscansendtextIMinachatlikeway,callacontactbyphoneorevensendanSMStoacontact.
Moreover,thepositionofeachcontactcanbeseenonthemapatanytimeanditiscontinuouslyupdated.
jChat1.3hasbeentestedonthefirstAndroidphone:
theTMobileG1phone.
AndroidjChat1.3setup
InordertobeabletostartandusethejChat1.3application,afewconfigurationstepsarerequired.
Settingthephonenumber
jChat1.3applicationusesthephonenumberastheagentIDofeachcontact.WhenrunningoftherealphonetheapplicationtriestoretrievetherealphonenumberusingtheAndroidAPI.IfforsomereasonthephonenumbercannotberetrieveditmustbesetusingtheJadeSettingdialog(seeConnectingtoJADE)
DuetosomeAPIchangesfromAndroidSDK0.9to1.0,phonenumbercustomizationisnomorepossibleontheemulator.Inthiscase,jChat1.3usestheemulatordefaulttelephonenumberandappendsarandomintegertoensuretheuniquenesswhenusingmultipleinstancesofthephoneemulator.
CustomizingtheGPSlocationprovider
jChat1.3allowstoausertoseebothhispositionandhiscontact’sonamap.Todoso,amockedGPSlocationproviderisused.jChat1.3usedamockedGPSservicerunningonthephone.
SinceAndroidSDK1.0removedtheAPIusedbythelocationproviderservice,thissolutionisnomoreapplicable.
TosendcustomtrackstojChat1.3youcanusethecustomLocationProvidertoolthatisprovidedunder/toolsdirectoryinthesourcetree.
PleasenotethatthistoolisastandardJ2SEapplicationusingJava1.5andswt,whichhasbeenwrittenusingthesamelibrariesusedbytheddmstoolprovidedwithAndroidSDK.
Youcaneasilybuildandrunthisnewtoolbyusingantwiththeprovidedbuild.xml
Figure1
Todoso,youhaveto:
∙Goto
∙Editthebuild.propertiesfile,settingandroid-sdk-folderpropertytothepathofyourAndroid1.0SDK
∙Typeantattheshellprompt
∙YoushouldbeabletoseetheLocationControltoolGUI.
∙Launchanemulator.Assoonastheemulatorconnectstoadb,youshouldbeabletoseeitintheAvailableDevicespanel.
∙ClickontheemulatoriconinAvailableDevicespanel.
∙ClickontheLoadKML…andchooseaKMLtrackfiletoimport.Youshouldnowbeabletoseeallthepositionsinthetrack.PleasenotethattheKMLparseronlylooksfordatainside
∙YouareabletosetLoopMode(locationswillbefiredfrombeginningtoendandbackforever)byclickingtheLoopModeenabledcheckbox.
∙Youareabletosetthedelayinmillisecondsbetweenthefiringoftwoconsecutivepositionsinthetrack,bysettingitinthecheckbox
∙IfyoupressthePlayRoutebutton,thedefaultgpsproviderontheemulatorshallbegintoreceivepositionupdates.IfyoustartjChat,youshouldbeabletoseeyouownpositionchangingovertimeinthemaptab.
∙YouareabletostoptheupdateanytimebypressingStopRoutebutton.YouarealsofreetolaunchasecondemulatorinstanceandsendupdatestoitbyclickingonitsiconinAvailableDevicesandrepeatingtheprocedure.Youshouldbeabletohandlemultipleemulatorinstanceswithdifferentdataplayingatthesametime.
∙Ifyouclosethetoolwindow,alltherunningupdatesshallbestopped.
LaunchingJADEmaincontainer
TobeabletorunjChat1.3,aJADELeapmaincontainermustbelaunched.
AJADELeapcontainerMUSTberunningwhenjChat1.3connectstoit,otherwisetheapplicationwillhang.
Thesearethestepsthatshouldbeexecuted:
1.DownloadthelastJADE-Leapsourcesfrom
2.Unpackthesourcessomewhere
3.BuildJADELeapforJ2SEfollowingtheinstructionprovidedwithJADEsources.Ifthebuildissuccessful,aJadeLeap.jarfileisavailable.
4.LaunchaJADELeapmaincontainer,togetherwithJADERMAGUIissuingthefollowingcommand
java-cp
Pleasenotethattheoption-Djade_domain_df_autocleanup=trueisnecessarytocorrectlycleanuptheDFagent.
UsingAndroidjChat1.3
ConnectingtoJADE
ThefirststepforusingjChat1.3istheconnectiontoaJADELeapmaincontainerrunningonahostmachine(localorremote).Pleasenotethat(differentlyfromjChat1.0)beforeconnectingtoJadethescreenwillappearblack.TheGUISHALLbecomevisibleonlyafterasuccessfulconnectiontoJadeLeap.
Thedefaulthostmachineandtheportforthemaincontainerarespecifiedonstrings.xmlfileduringcompilation(thisisthedefaultvalue).
Figure2
Tochangethesesettingsperformthefollowingsteps(seeFigure1):
1.PresstheMENUkeyontheemulator
2.ChooseSettings
3.Inserttheneededsettings(hostandportandphonenumberifempty).Youarealsoabletoselectthedesiredlocationprovider(onarealphoneyoucanusetheGPSorthenetworkifGPSisnotavailable,ontheemulatorjustselectgpsforthemockedprovider).RememberthatthelocalhostaddressonAndroidemulatoris10.0.2.2.jChat1.3shallnowrememberthesettingsyouchooseintheJadeConnectionsettingsmenustoringthemasapreference,soyoudon’thavetoenterthemanytimeyoulaunchtheapplication
4.PressClosebutton
5.PresstheMENUkeyontheemulator
6.ChooseConnecttoJade!
Ifrunningonarealphonerememberthatyourhostmustbevisiblethroughthenetworkused(3Gorwifi).
IftheconnectiontoJadeplatformissuccessfulyoushouldbeabletoseethenewagentrunningonAndroidemulatorintoJadeRemoteAgentManagementGUI.
Figure3
Thenameofthenewagentshouldbethesameasthephonenumberofthephone.
KnowingjChat1.3tabs
Themainscreenisdividedintotwodifferenttabs,providingcontactsinformationindifferentvisualways.
TheContacttab
Figure4
Thecontacttabcontainsalistofallcurrentlyavailablecontacts.
Anycontactcanbeonline(connectedtoourJADELeapplatform)oroffline.
Onlinecontactsareshowninblue,whileofflinecontactsareshowninred.
Foreachonlinecontactthedistanceinkmbetweenthephoneownerandthecontactisshown.
Themaptab
Figure5
Themaptabshowsthepositionofeachonlinecontactonamapandcontinuouslyupdatestheirposition.
Eachcontactisvisibleasapinofdifferentcolors:
thephoneownercanseehisownpositionasayellowpin,whileotherscontactsareshownasbluepins.
Mapscanbeseenbothintraditionalmapmodeandinsatellitemode:
theuserisabletoswitchbetweenthetwomodesusingtheswitchbuttonplacedrightabovethemap.
Pickingcontacts
Tobeabletocommunicatewithothers,usersmustfirstselectcontacts(“picking”).
Youcanpickoneormorecontactsinbothcontacttabandmaptab.
Incontacttab,youhavetoclickonthecheckboxbesideeachcontact.Inmaptabyousimplyclickonthepinrepresentationofthecontact.
Figure6
Pleasenotethatcontactselectionislocaltothemap(youcannotbeginselectingcontactinatab,thenswitchtotheothertabandcontinueselection).
Aftercontactsselection,youcandecidehowtointeractbypressingforsomesecondstheemulatorselectionbuttonandchoosingthedesiredoptionfromthecontextmenuthatwillpopup.
Interactingwithcontacts
Userscancommunicatewithcontactsinthreeways:
SMS,phonecallsorchatsessions.
SendinganSMStooneormorecontacts
AfterchoosingtosendanSMSmessage,userwillberedirectedtotheSMSsendingscreen.Obviouslyamessagecanbesenttomorethanonecontactatthesametime.
Figure7
Herehewillbeabletoenterthemessagetextandtosendit.
Messageshallbesplitintochunksiftoolongandsenttothedesiredcontact/s.
PleasenotethatatthemomenttheemulatordoesnotsupportSMSsendingemulation,sonothingshallbereceived.TheSMSsendingprocessismockedanditalwayssucceeds.SMSsendingprocessisrealontheG1hardware.
Callingacontact
Ifyouchoosetocallacontact,thecallingscreenshallappearandthecallshallstart.
Figure8
Obviously,thephonecallistotallymockedontheemulatorwhileitisarealphonecallontheG1.
Ifyoutrytocallmorethanonecontactatthesametime(byselectingmanycontactsandchoosingCallfromcontextmenu)amessageshallappearwarningthatonlyonecontactcanbecalledatthesametime.
Startingachatsession
Wedefinechatsessionasagroupoftwoormorecontactstalkingtogether.
Achatsessioncanbestartedbythephoneowner(byselectingcontactsandchoosingChatfromthecontextmenu)orb
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- Android jChat用户手册 jChat 用户手册