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\tools\LocationControlToolfolderonacommandshell
∙Editthebuild.propertiesfile,settingandroid-sdk-folderpropertytothepathofyourAndroid1.0SDK
∙Typeantattheshellprompt
∙YoushouldbeabletoseetheLocationControltoolGUI.
∙Launchanemulator.Assoonastheemulatorconnectstoadb,youshouldbeabletoseeitintheAvailableDevicespanel.
∙ClickontheemulatoriconinAvailableDevicespanel.
∙ClickontheLoadKML…andchooseaKMLtrackfiletoimport.Youshouldnowbeabletoseeallthepositionsinthetrack.PleasenotethattheKMLparseronlylooksfordatainsidetaginsideelement.Anyotherdatashallbeignored!
∙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\JadeLeap.jar-Djade_domain_df_autocleanup=truejade.Boot-gui
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
升级会员 