SL4A之Python API 中文参考

1、 SL4A之Python资源中文化项目 ApiReference !Activityresultfacade setresultboolean setresultbooleanarray setresultbyte setresultbytearray setresultchar setresultchararray setresultdouble setresultdoublearray setresultfloat setresultfloatarray setresultinteger setresultintegerarray setresultlong setresultlongar

2、ray setresultserializable setresultshort setresultshortarray setresultstring setresultstringarray!Alarmmanagerfacade cancelrepeating scheduleabsolute scheduleinexactrepeating schedulerelative schedulerepeating!Androidfacade getclipboard getinput getintent getpackageversion getpackageversioncode getp

3、assword log maketoast notify requiredversion sendemail setclipboard startactivity startactivityforresult vibrate!Applicationmanagerfacade forcestoppackage getlaunchableapplications getrunningpackages launch!Batterymanagerfacade batterycheckpresent batterygethealth batterygetlevel batterygetplugtype

4、batterygetstatus batterygettechnology batterygettemperature batterygetvoltage batterystartmonitoring batterystopmonitoring readbatterydata!Bluetoothfacade bluetoothaccept bluetoothconnect bluetoothgetconnecteddevicename bluetoothmakediscoverable bluetoothread bluetoothreadline bluetoothreadready blu

5、etoothstop bluetoothwrite checkbluetoothstate togglebluetoothstate!Camerafacade cameracapturepicture camerainteractivecapturepicture!Commonintentsfacade pick scanbarcode search view viewcontacts viewhtml viewmap!Conditionmanagerfacade onringersilent!Contactsfacade contactsget contactsgetattributes c

6、ontactsgetbyid contactsgetcount contactsgetids pickcontact pickphone!Eventfacade postevent receiveevent waitforevent!Locationfacade geocode getlastknownlocation readlocation startlocating stoplocating!Mediarecorderfacade recordercapturevideo recorderstartmicrophone recorderstop startinteractivevideo

7、recording!Phonefacade checknetworkroaming getcelllocation getdeviceid getdevicesoftwareversion getline1number getneighboringcellinfo getnetworkoperator getnetworkoperatorname getnetworktype getphonetype getsimcountryiso getsimoperator getsimoperatorname getsimserialnumber getsimstate getsubscriberid

8、 getvoicemailalphatag getvoicemailnumber phonecall phonecallnumber phonedial phonedialnumber readphonestate starttrackingphonestate stoptrackingphonestate!Pulsegeneratorfacade pulsegeneratorgethz pulsegeneratorgethzsamples pulsegeneratorgetleftpulsems pulsegeneratorgetleftpulsepercent pulsegenerator

9、getleftpulsesamples pulsegeneratorgetrightpulsems pulsegeneratorgetrightpulsepercent pulsegeneratorgetrightpulsesamples pulsegeneratorisplaying pulsegeneratorrun pulsegeneratorsethzpercent pulsegeneratorsetleftpulsepercent pulsegeneratorsetrightpulsepercent pulsegeneratorstop pulsegeneratortoggleinv

10、erted pulsegeneratortoggleplayback pulsegenteratorsethz!Sensormanagerfacade readsensors sensorsgetaccuracy sensorsgetlight sensorsreadaccelerometer sensorsreadmagnetometer sensorsreadorientation startsensing stopsensing!Settingsfacade checkairplanemode checkringersilentmode checkscreenon getmaxmedia

11、volume getmaxringervolume getmediavolume getringervolume getscreenbrightness getscreentimeout setmediavolume setringervolume setscreenbrightness setscreentimeout toggleairplanemode toggleringersilentmode!Signalstrengthfacade 需要 api level 7. readsignalstrengths starttrackingsignalstrengths stoptracki

12、ngsignalstrengths!Smsfacade smsdeletemessage smsgetattributes smsgetmessagebyid smsgetmessagecount smsgetmessageids smsgetmessages smsmarkmessageread smssend!Speechrecognitionfacade recognizespeech!Texttospeechfacade 需要 api level 4. ttsisspeaking ttsspeak!Tonegeneratorfacade generatedtmftones!Uifaca

13、de addcontextmenuitem addoptionsmenuitem clearcontextmenu clearoptionsmenu dialogcreatealert dialogcreatedatepicker dialogcreatehorizontalprogress dialogcreateinput dialogcreatepassword dialogcreateseekbar dialogcreatespinnerprogress dialogcreatetimepicker dialogdismiss dialoggetinput dialoggetpassw

14、ord dialoggetresponse dialoggetselecteditems dialogsetcurrentprogress dialogsetitems dialogsetmaxprogress dialogsetmultichoiceitems dialogsetnegativebuttontext dialogsetneutralbuttontext dialogsetpositivebuttontext dialogsetsinglechoiceitems dialogshow webviewshowWakeLockFacade wakeLockAcquireBright

15、 wakeLockAcquireDim wakeLockAcquireFull wakeLockAcquirePartial wakeLockReleaseWifiFacade checkWifiState toggleWifiState wifiDisconnect wifiGetConnectionInfo wifiGetScanResults wifiLockAcquireFull wifiLockAcquireScanOnly wifiLockRelease wifiReassociate wifiReconnect wifiStartScansetresultboolean设置脚本被

16、startactivityforresult()方法调用后返回的布尔值:setresultboolean( integer resultcode:回传给原始activity的结果编码, 常常是result_canceled(0) 或者 result_ok(-1),boolean resultvalue)设置脚本执行的结果.每当脚本程序被startactivityforresult()方法调用时,由此产生的intent将会包含script_result和给定的值.setresultbooleanarray设置脚本被startactivityforresult()方法调用后返回的布尔值数组:set

17、resultboolean( integer resultcode:回传给原始activity的结果编码, 常常是result_canceled(0) 或者 result_ok(-1),boolean resultvalue)设置脚本执行的结果.每当脚本程序被startactivityforresult()方法调用时,由此产生的intent将会包含script_result和给定的值.setresultbyte设置脚本被startactivityforresult()方法调用后返回的字节:setresultbyte( integer resultcode:回传给原始activity的结果编码,

18、 常常是result_canceled(0) 或者 result_ok(-1),byte resultvalue)设置脚本执行的结果.每当脚本程序被startactivityforresult()方法调用时,由此产生的intent将会包含script_result和给定的值.setresultbytearray设置脚本被startactivityforresult()方法调用后返回的字节数组:setresultbytearray( integer resultcode:回传给原始activity的结果编码, 常常是result_canceled(0) 或者 result_ok(-1),byte

19、 resultvalue)设置脚本执行的结果.每当脚本程序被startactivityforresult()方法调用时,由此产生的intent将会包含script_result和给定的值.setresultchar设置脚本被startactivityforresult()方法调用后返回的字符:setresultchar( integer resultcode:回传给原始activity的结果编码, 常常是result_canceled(0) 或者 result_ok(-1), character resultvalue)设置脚本执行的结果.每当脚本程序被startactivityforresu

20、lt()方法调用时,由此产生的intent将会包含script_result和给定的值.setresultchararray设置脚本被startactivityforresult()方法调用后返回的字符数组:setresultchararray( integer resultcode:回传给原始activity的结果编码, 常常是result_canceled(0) 或者 result_ok(-1), character resultvalue)设置脚本执行的结果.每当脚本程序被startactivityforresult()方法调用时,由此产生的intent将会包含script_result

21、和给定的值.setresultdouble设置脚本被startactivityforresult()方法调用后返回的的双精度浮点数值:setresultdouble( integer resultcode:回传给原始activity的结果编码, 常常是result_canceled(0) 或者 result_ok(-1),double resultvalue)设置脚本执行的结果.每当脚本程序被startactivityforresult()方法调用时,由此产生的intent将会包含script_result和给定的值.setresultdoublearray设置脚本被startactivity

22、forresult()方法调用后返回的双精度浮点数值数组:setresultdoublearray( integer resultcode:回传给原始activity的结果编码, 常常是result_canceled(0) 或者 result_ok(-1),double resultvalue)设置脚本执行的结果.每当脚本程序被startactivityforresult()方法调用时,由此产生的intent将会包含script_result和给定的值.setresultfloat设置脚本被startactivityforresult()方法调用后返回的的单精度浮点数值:setresultfl

23、oat( integer resultcode: 回传给原始activity的结果编码, 常常是result_canceled(0) 或者 result_ok(-1),float resultvalue)设置脚本执行的结果.每当脚本程序被startactivityforresult()方法调用时,由此产生的intent将会包含script_result和给定的值.setresultfloatarray设置脚本被startactivityforresult()方法调用后返回的单精度浮点型数组:setresultfloatarray( integer resultcode: 回传给原始activi

24、ty的结果编码, 常常是result_canceled(0) 或者 result_ok(-1),float resultvalue)设置脚本执行的结果.每当脚本程序被startactivityforresult()方法调用时,由此产生的intent将会包含script_result和给定的值.setresultinteger设置脚本被startactivityforresult()方法调用后返回的整数:setresultinteger( integer resultcode: 回传给原始activity的结果编码, 常常是result_canceled(0) 或者 result_ok(-1),

25、 integer resultvalue)设置脚本执行的结果.每当脚本程序被startactivityforresult()方法调用时,由此产生的intent将会包含script_result和给定的值.setresultintegerarray设置脚本被startactivityforresult()方法调用后返回的整型数组:setresultintegerarray( integer resultcode: 回传给原始activity的结果编码, 常常是result_canceled(0) 或者 result_ok(-1), integer resultvalue)设置脚本执行的结果.每当

26、脚本程序被startactivityforresult()方法调用时,由此产生的intent将会包含script_result和给定的值.setresultlong设置脚本被startactivityforresult()方法调用后返回的长整数:setresultlong( integer resultcode: 回传给原始activity的结果编码, 常常是result_canceled(0) 或者 result_ok(-1),long resultvalue)设置脚本执行的结果.每当脚本程序被startactivityforresult()方法调用时,由此产生的intent将会包含scri

27、pt_result和给定的值.setresultlongarray设置脚本被startactivityforresult()方法调用后返回的长整型数组:setresultlongarray( integer resultcode: 回传给原始activity的结果编码, 常常是result_canceled(0) 或者 result_ok(-1),long resultvalue)设置脚本执行的结果.每当脚本程序被startactivityforresult()方法调用时,由此产生的intent将会包含script_result和给定的值.setresultserializable设置脚本被s

28、tartactivityforresult()方法调用后返回的可串行化的结果(serializable):setresultserializable( integer resultcode: 回传给原始activity的结果编码, 常常是result_canceled(0) 或者 result_ok(-1), serializable resultvalue)设置脚本执行的结果.每当脚本程序被startactivityforresult()方法调用时,由此产生的intent将会包含script_result和给定的值.setresultshort设置脚本被startactivityforres

29、ult()方法调用后返回的短整数:setresultshort( integer resultcode: 回传给原始activity的结果编码, 常常是result_canceled(0) 或者 result_ok(-1),short resultvalue)设置脚本执行的结果.每当脚本程序被startactivityforresult()方法调用时,由此产生的intent将会包含script_result和给定的值.setresultshortarray设置脚本被startactivityforresult()方法调用后返回的短整型数组:setresultshortarray( intege

30、r resultcode: 回传给原始activity的结果编码, 常常是result_canceled(0) 或者 result_ok(-1),short resultvalue)设置脚本执行的结果.每当脚本程序被startactivityforresult()方法调用时,由此产生的intent将会包含script_result和给定的值.setresultstring设置脚本被startactivityforresult()方法调用后返回的字符串:setresultstring( integer resultcode: 回传给原始activity的结果编码, 常常是result_cance

31、led(0) 或者 result_ok(-1),string resultvalue)设置脚本执行的结果.每当脚本程序被startactivityforresult()方法调用时,由此产生的intent将会包含script_result和给定的值.setresultstringarray设置脚本被startactivityforresult()方法调用后返回的字符串数组:setresultstringarray( integer resultcode: 回传给原始activity的结果编码, 常常是result_canceled(0) 或者 result_ok(-1),string resul

32、tvalue)设置脚本执行的结果.每当脚本程序被startactivityforresult()方法调用时,由此产生的intent将会包含script_result和给定的值.cancelrepeating取消脚本的定时执行计划:cancelrepeating(string script)取消给定脚本所有的定时(重复)执行计划scheduleabsolute定时执行传入的脚本，从开机后开始计时：scheduleabsolute(string script: 要执行的脚本,double time: 脚本延迟执行时间, 开机(epoch?)后延迟一定时间执行脚本,延迟的时间由此参数指定boolea

33、n wakeupoptional, default true: 是否唤醒处于黑屏状态的移动设备)定时执行传入的脚本,从开机后开始计时scheduleinexactrepeating每隔一段端时间执行一次脚本（时间间隔不太精确）scheduleinexactrepeating(double interval: 两次执行之间的时间间隔,以秒为单位string script: 要执行的脚本,boolean wakeupoptional, default true: 是否唤醒处于黑屏状态的移动设备)从脚本被调用开始,每隔一段时间执行一次脚本(不是很精确),但是比schedulerepeating方法省

34、电schedulerelative定时执行脚本,延迟时间从方法被调用时开始计算schedulerelative(string script: 要执行的脚本,double secondsfromnow: 从现在起,延迟一定时间执行脚本,延迟时间由此参数指定boolean wakeupoptional, default true: 是否唤醒处于黑屏状态的移动设备)从脚本被调用开始，延迟数秒钟后执行脚schedulerepeating每隔一段时间执行一次脚本（精确）schedulerepeating(double interval: 两次执行之间的时间间隔,以秒为单位string script: 要

35、执行的脚本,double firstexecutiontimeoptional: 第一次执行脚本所需要延迟的时间,从开机(epoch?)开始计算boolean wakeupoptional, default true:是否唤醒处于黑屏状态的移动设备)每隔一段时间执行一次脚本,从开机开始计算getclipboard读取剪贴板中的文本getclipboard()从剪贴板中读取文本。返回值:剪贴板中的文本。getinput请求用户输入文本getinput(string title可选, 默认为 sl4a inpu: 输入框的标题string messagek可选, 默认为 please enter

36、value: 输入框的提示信息)请求用户输入文本信息已废弃，请使用dialoggetinput方法替代。getintent获取启动脚本的intentgetintent()返回启动脚本的intentgetpackageversion返回包的版本名getpackageversion(string packagename)返回包的版本名getpackageversioncode返回包的版本号getpackageversioncode(string packagename)返回包的版本号getpassword请求用户输入密码getpassword(string titleoptional, defau

37、lt sl4a password input: title of the input box,string messageoptional, default please enter password: message to display above the input box)请求用户输入密码。已废弃!请使用dialoggetpassword方法替代。log写日志log(string message)向logcat中写入信息。maketoast显示短暂提示框maketoast(string message)显示一个持续短暂时间的提示框。notify通知notify(string title

38、: 标题,string message)显示一个通知，在用户点击后会取消。requiredversion检测版本信息requiredversion( integer requiredversion)检测当前sl4a的版本是否大于制定的版本。sendemail发邮件sendemail(string to: 一系列的收件人列表，用逗号分隔。string subject,string body,string attachmenturi可选)启动一个发送邮件的activity，将内容发送给接收者。setclipboard向剪贴板写入信息setclipboard(string text)向剪贴板写入信息

39、。startactivity启动一个activitystartactivity(string action,string uri可选,string typek可选: uri的mime类型/子类型, jsonobject extras可选: 要添加到intent的附加数据，以map形式保存,boolean wait可选: 阻塞当前应用知道打开的activity被关闭)启动一个activitystartactivityforresult运行一个activity并返回结果startactivityforresult(string action,string uri可选,string type可选:

40、uri的mime类型/子类型, jsonobject extras可选: 要添加到intent的附加数据，以map形式保存)运行一个activity并返回结果返回:最终的intent,以map形式呈现vibrate震动vibrate( integer duration可选, 默认为 300: 持续时间,以毫秒为单位)使手机震动指定的时间。forcestoppackage强制终止一个包forcestoppackage(string packagename: 包名)强制终止一个包。getlaunchableapplications获得可运行的应用getlaunchableapplications(

41、)返回一个可以运行的应用类名列表getrunningpackages返回正在运行的activity或者服务的列表getrunningpackages()返回一个正在运行的activity或者服务的列表。返回:一个正在运行activity的列表。launch启动一个activitylaunch(string classname)按照给定的类名启动一个activity。batterycheckpresent查看电池电量信息:batterycheckpresent()返回当前的电池电量信息需要 api level 5.batterygethealth查看电池健康状态:batterygethealth

42、()返回当前的电池健康状态信息:1 - 未知;2 - 良好;3 - 过热;4 - 不可用;5 - 电量过饱;6 - 查询失败;batterygetlevelbatterygetlevel()返回电池电量(百分比形式)需要 api level 5.batterygetplugtype返回充电状态信息batterygetplugtype()返回充电电源信息-1 - 未知;0 - 为插入电源;1 - 交流电源充电;2 - usb充电batterygetstatus返回充电状态信息batterygetstatus()返回充电状态信息1 - 未知;2 - 充电中;3 - 放电中;4 - 为充电;5 -

43、已充满;batterygettechnologybatterygettechnology()返回电池技术数据需要 api level 5.batterygettemperature返回电池温度batterygettemperature()返回当前电池的温度.需要 api level 5.batterygetvoltage返回电池的电压batterygetvoltage()返回当前电池的电压.需要 api level 5.batterystartmonitoring开始监视电池状态batterystartmonitoring()开始监视电池状态.触发 battery 事件.batterystop

44、monitoring停止监视电池状态batterystopmonitoring()停止监视电池状态readbatterydata读取电池记录数据readbatterydata()读取当前记录的电池数据bluetoothaccept监听并接受一个蓝牙连接bluetoothaccept(string uuid可选, 默认值为 c0-4897-11df-9879-c9a66)监听并接受一个蓝牙连接。阻塞直到连接建立或者连接失败。需要 api level 5.bluetoothconnect通过蓝牙与一个移动终端进行连接bluetoothconnect(string uuid可选, 默认值为 c0-4

45、897-11df-9879-c9a66: 此处的 uuid 必须与服务端使用的uuid相匹配,string address可选: 如果未提供此参数，将会给用户显示一个发现的可连接的移动终端列表工用户选择。)通过蓝牙与一个移动终端进行连接。阻塞直到连接建立或者连接失败。returns:连接建立成功则返回true。需要 api level 5.bluetoothgetconnecteddevicename获取已连接的移动终端的的名称bluetoothgetconnecteddevicename()获取已连接的移动终端的的名称。需要 api level 5.bluetoothmakediscover

46、able设置蓝牙为可见状态bluetoothmakediscoverable( integer duration可选, 默认 300: 移动终端蓝牙可见时间,以秒为单位)设置蓝牙连接在一段时间内为可见状态。需要 api level 5.bluetoothread读取指定长度的数据bluetoothread( integer buffersize可选, 默认为 4096)读取指定长度的数据，长度由buffersize参数指定。需要 api level 5.bluetoothreadline读取下一行数据bluetoothreadline()读取下一行数据.需要 api level 5.bluet

47、oothreadready判断是否全部读取完成bluetoothreadready()还有后续数据可供读取，则返回true。需要 api level 5.bluetoothstop终端蓝牙连接bluetoothstop()终端蓝牙连接。需要 api level 5.bluetoothwrite通过当前打开的蓝牙连接传送数据bluetoothwrite(string bytes)通过当前打开的蓝牙连接传送数据。需要 api level 5.checkbluetoothstate检测蓝牙连接的状态checkbluetoothstate()检测蓝牙连接的状态。returns:如果连接已经建立,则返回

48、true。需要 api level 5.togglebluetoothstate打开或者关闭蓝牙togglebluetoothstate(boolean enabled可选,boolean prompt可选, 默认 true: 是否提示用户当前蓝牙状态已改变)打开或者关闭蓝牙。returns:如果蓝牙可用，则返回true。需要 api level 5.cameracapturepicture直接调用镜头并拍照cameracapturepicture(string path,boolean useautofocus可选, 默认为 true)拍照并保存到指定的路径。返回值: map形式的列表,键为

49、autofocus和takepicture,值代表是否自动对焦和是否拍摄成功.camerainteractivecapturepicture启动拍照程序拍照并保存到指定位置camerainteractivecapturepicture(string path)启动拍照程序拍照并保存到指定位置。pick显示要被uri选取的内容pick(string uri)显示要被uri选取的内容（例如 联系人）returns:结果集合，以map形式保存。scanbarcode运行二维码扫描器scanbarcode()运行二维码扫描器。returns:显示结果intent的map集合.search搜索给定的查询

50、字符串search(string query)搜索给定的查询字符串。view通过uri运行一个带有view action的activityview(string uri,string type可选: mime type/subtype uri的mime类型/子类型, jsonobject extras可选: intent中要添加额外信息的map集合)通过uri运行一个带有view action的activity。viewcontacts打开联系人列表viewcontacts()打开联系人列表。viewhtml打开浏览器显示本地的html文件viewhtml(string path: html

51、文件的路径)打开浏览器显示本地的html文件。viewmap打开地图，搜索指定的查询字符串viewmap(string query,例如 pizza, 123 my street)打开地图，搜索指定的查询字符串 (例如 pizza, 123 my street)。onringersilent当响铃模式被设置为静音时执行指定脚本onringersilent(string script: 响铃模式改变时执行脚本的路径。)当响铃模式被设置为静音时执行指定脚本。contactsget以列表的形式返回所有的联系人contactsget( jsonarray attributes可选)以列表的形式返回所有

52、的联系人。returns: map形式的联系人列表。contactsgetattributes以列表的形式返回所有联系人相关的属性信息contactsgetattributes()以列表的形式返回所有联系人相关的属性信息。contactsgetbyid获取指定id的联系人信息contactsgetbyid( integer id, jsonarray attributes可选)获取指定id的联系人信息。contactsgetcount获取联系人总数contactsgetcount()获取联系人总数。contactsgetids返回所有联系人的idcontactsgetids()返回所有联系人的id。pickcontact列出所有的联系人供用户选择pickcontact()列出所有的联系人供用户选择。returns:以map的形式返回选中的结果。pickphone列出所有电话号码供用户选pickphone()列出所有电话号码供用户选择。returns:选中的电话号码。postevent向事件列表中添加一个事件postevent(string name,string data)向事件列表中添加一个事件。receiveevent接受发生的事件receiveevent()接受发生的事件（例如位置或者传感器更新等）并从事件列表中把它删除(事件列表最多能存放最近触发的1024