2022年SLA之PythonAPI中文参考 .pdf

SL4A 之 Python 资源中文化项目ApiReference!Activityresultfacadesetresultbooleansetresultbooleanarraysetresultbytesetresultbytearraysetresultcharsetresultchararraysetresultdoublesetresultdoublearraysetresultfloatsetresultfloatarraysetresultintegersetresultintegerarraysetresultlongsetresultlongarraysetresultserializablesetresultshortsetresultshortarraysetresultstringsetresultstringarray!Alarmmanagerfacade cancelrepeatingscheduleabsolutescheduleinexactrepeatingschedulerelativeschedulerepeating!Androidfacade getclipboardgetinputgetintentgetpackageversiongetpackageversioncodegetpasswordlogmaketoastnotifyrequiredversionsendemailsetclipboardstartactivitystartactivityforresultvibrate!Applicationmanagerfacade 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 1 页，共 47 页 - - - - - - - - - forcestoppackagegetlaunchableapplicationsgetrunningpackageslaunch!Batterymanagerfacade batterycheckpresentbatterygethealthbatterygetlevelbatterygetplugtypebatterygetstatusbatterygettechnologybatterygettemperaturebatterygetvoltagebatterystartmonitoringbatterystopmonitoringreadbatterydata!Bluetoothfacade bluetoothacceptbluetoothconnectbluetoothgetconnecteddevicenamebluetoothmakediscoverablebluetoothreadbluetoothreadlinebluetoothreadreadybluetoothstopbluetoothwritecheckbluetoothstatetogglebluetoothstate!Camerafacade cameracapturepicturecamerainteractivecapturepicture!Commonintentsfacade pickscanbarcodesearchviewviewcontactsviewhtmlviewmap!Conditionmanagerfacade onringersilent!Contactsfacade contactsgetcontactsgetattributes名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 2 页，共 47 页 - - - - - - - - - contactsgetbyidcontactsgetcountcontactsgetidspickcontactpickphone!Eventfacade posteventreceiveeventwaitforevent!Locationfacade geocodegetlastknownlocationreadlocationstartlocatingstoplocating!Mediarecorderfacade recordercapturevideorecorderstartmicrophonerecorderstopstartinteractivevideorecording!Phonefacade checknetworkroaminggetcelllocationgetdeviceidgetdevicesoftwareversiongetline1numbergetneighboringcellinfogetnetworkoperatorgetnetworkoperatornamegetnetworktypegetphonetypegetsimcountryisogetsimoperatorgetsimoperatornamegetsimserialnumbergetsimstategetsubscriberidgetvoicemailalphataggetvoicemailnumberphonecallphonecallnumberphonedialphonedialnumberreadphonestate名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 3 页，共 47 页 - - - - - - - - - starttrackingphonestatestoptrackingphonestate!Pulsegeneratorfacade pulsegeneratorgethzpulsegeneratorgethzsamplespulsegeneratorgetleftpulsemspulsegeneratorgetleftpulsepercentpulsegeneratorgetleftpulsesamplespulsegeneratorgetrightpulsemspulsegeneratorgetrightpulsepercentpulsegeneratorgetrightpulsesamplespulsegeneratorisplayingpulsegeneratorrunpulsegeneratorsethzpercentpulsegeneratorsetleftpulsepercentpulsegeneratorsetrightpulsepercentpulsegeneratorstoppulsegeneratortoggleinvertedpulsegeneratortoggleplaybackpulsegenteratorsethz!Sensormanagerfacade readsensorssensorsgetaccuracysensorsgetlightsensorsreadaccelerometersensorsreadmagnetometersensorsreadorientationstartsensingstopsensing!Settingsfacade checkairplanemodecheckringersilentmodecheckscreenongetmaxmediavolumegetmaxringervolumegetmediavolumegetringervolumegetscreenbrightnessgetscreentimeoutsetmediavolumesetringervolumesetscreenbrightnesssetscreentimeouttoggleairplanemode名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 4 页，共 47 页 - - - - - - - - - toggleringersilentmode!Signalstrengthfacade 需要api level 7. readsignalstrengthsstarttrackingsignalstrengthsstoptrackingsignalstrengths!Smsfacade smsdeletemessagesmsgetattributessmsgetmessagebyidsmsgetmessagecountsmsgetmessageidssmsgetmessagessmsmarkmessagereadsmssend!Speechrecognitionfacade recognizespeech!Texttospeechfacade 需要 api level 4. ttsisspeakingttsspeak!Tonegeneratorfacade generatedtmftones!Uifacade addcontextmenuitemaddoptionsmenuitemclearcontextmenuclearoptionsmenudialogcreatealertdialogcreatedatepickerdialogcreatehorizontalprogressdialogcreateinputdialogcreatepassworddialogcreateseekbardialogcreatespinnerprogressdialogcreatetimepickerdialogdismissdialoggetinputdialoggetpassworddialoggetresponsedialoggetselecteditemsdialogsetcurrentprogressdialogsetitemsdialogsetmaxprogressdialogsetmultichoiceitemsdialogsetnegativebuttontext名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 5 页，共 47 页 - - - - - - - - - dialogsetneutralbuttontextdialogsetpositivebuttontextdialogsetsinglechoiceitemsdialogshowwebviewshowWakeLockFacade wakeLockAcquireBrightwakeLockAcquireDimwakeLockAcquireFullwakeLockAcquirePartialwakeLockReleaseWifiFacade checkWifiStatetoggleWifiStatewifiDisconnectwifiGetConnectionInfowifiGetScanResultswifiLockAcquireFullwifiLockAcquireScanOnlywifiLockReleasewifiReassociatewifiReconnectwifiStartScansetresultboolean设置脚本被startactivityforresult() 方法调用后返回的布尔值: setresultboolean( integer resultcode:回传给原始activity 的结果编码 , 常常是 result_canceled(0) 或者result_ok(-1), boolean resultvalue) 设置脚本执行的结果.每当脚本程序被startactivityforresult() 方法调用时 ,由此产生的intent 将会包含script_result 和给定的值 . setresultbooleanarray设置脚本被startactivityforresult() 方法调用后返回的布尔值数组: setresultboolean( integer resultcode:回传给原始activity 的结果编码 , 常常是 result_canceled(0) 或者result_ok(-1), boolean resultvalue) 设置脚本执行的结果.每当脚本程序被startactivityforresult() 方法调用时 ,由此产生的intent 将会包含script_result 和给定的值 . 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 6 页，共 47 页 - - - - - - - - - setresultbyte设置脚本被startactivityforresult() 方法调用后返回的字节: setresultbyte( integer resultcode:回传给原始activity 的结果编码 , 常常是 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 resultvalue) 设置脚本执行的结果.每当脚本程序被startactivityforresult() 方法调用时 ,由此产生的intent 将会包含script_result 和给定的值 . setresultchar设置脚本被startactivityforresult() 方法调用后返回的字符: setresultchar( integer resultcode:回传给原始activity 的结果编码 , 常常是 result_canceled(0) 或者result_ok(-1), character resultvalue) 设置脚本执行的结果.每当脚本程序被startactivityforresult() 方法调用时 ,由此产生的intent 将会包含script_result 和给定的值 . setresultchararray设置脚本被startactivityforresult() 方法调用后返回的字符数组: setresultchararray( integer resultcode:回传给原始activity 的结果编码 , 常常是 result_canceled(0) 或者result_ok(-1), character resultvalue) 设置脚本执行的结果.每当脚本程序被startactivityforresult() 方法调用时 ,由此产生的intent 将会包含script_result 和给定的值 . setresultdouble设置脚本被startactivityforresult() 方法调用后返回的的双精度浮点数值: 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 7 页，共 47 页 - - - - - - - - - setresultdouble( integer resultcode:回传给原始activity 的结果编码 , 常常是 result_canceled(0) 或者result_ok(-1), double resultvalue) 设置脚本执行的结果.每当脚本程序被startactivityforresult() 方法调用时 ,由此产生的intent 将会包含script_result 和给定的值 . setresultdoublearray设置脚本被startactivityforresult() 方法调用后返回的双精度浮点数值数组: setresultdoublearray( integer resultcode:回传给原始activity 的结果编码 , 常常是 result_canceled(0) 或者result_ok(-1), double resultvalue) 设置脚本执行的结果.每当脚本程序被startactivityforresult() 方法调用时 ,由此产生的intent 将会包含script_result 和给定的值 . setresultfloat设置脚本被startactivityforresult() 方法调用后返回的的单精度浮点数值: setresultfloat( integer resultcode: 回传给原始activity 的结果编码 , 常常是 result_canceled(0) 或者result_ok(-1), float resultvalue) 设置脚本执行的结果.每当脚本程序被startactivityforresult() 方法调用时 ,由此产生的intent 将会包含script_result 和给定的值 . setresultfloatarray设置脚本被startactivityforresult() 方法调用后返回的单精度浮点型数组: setresultfloatarray( integer resultcode: 回传给原始activity 的结果编码 , 常常是 result_canceled(0) 或者result_ok(-1), float resultvalue) 设置脚本执行的结果.每当脚本程序被startactivityforresult() 方法调用时 ,由此产生的intent 将会包含script_result 和给定的值 . setresultinteger设置脚本被startactivityforresult() 方法调用后返回的整数: setresultinteger( integer resultcode: 回传给原始activity 的结果编码 , 常常是 result_canceled(0) 或者result_ok(-1), 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 8 页，共 47 页 - - - - - - - - - integer resultvalue) 设置脚本执行的结果.每当脚本程序被startactivityforresult() 方法调用时 ,由此产生的intent 将会包含script_result 和给定的值 . setresultintegerarray设置脚本被startactivityforresult() 方法调用后返回的整型数组: setresultintegerarray( integer resultcode: 回传给原始activity 的结果编码 , 常常是 result_canceled(0) 或者result_ok(-1), integer resultvalue) 设置脚本执行的结果.每当脚本程序被startactivityforresult() 方法调用时 ,由此产生的intent 将会包含script_result 和给定的值 . setresultlong设置脚本被startactivityforresult() 方法调用后返回的长整数: setresultlong( integer resultcode: 回传给原始activity 的结果编码 , 常常是 result_canceled(0) 或者result_ok(-1), long resultvalue) 设置脚本执行的结果.每当脚本程序被startactivityforresult() 方法调用时 ,由此产生的intent 将会包含script_result 和给定的值 . setresultlongarray设置脚本被startactivityforresult() 方法调用后返回的长整型数组: setresultlongarray( integer resultcode: 回传给原始activity 的结果编码 , 常常是 result_canceled(0) 或者result_ok(-1), long resultvalue) 设置脚本执行的结果.每当脚本程序被startactivityforresult() 方法调用时 ,由此产生的intent 将会包含script_result 和给定的值 . setresultserializable设置脚本被startactivityforresult() 方法调用后返回的可串行化的结果(serializable): setresultserializable( integer resultcode: 回传给原始activity 的结果编码 , 常常是 result_canceled(0) 或者result_ok(-1), serializable resultvalue) 设置脚本执行的结果.每当脚本程序被startactivityforresult() 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 9 页，共 47 页 - - - - - - - - - 方法调用时 ,由此产生的intent 将会包含script_result 和给定的值 . setresultshort设置脚本被startactivityforresult() 方法调用后返回的短整数: setresultshort( integer resultcode: 回传给原始activity 的结果编码 , 常常是 result_canceled(0) 或者result_ok(-1), short resultvalue) 设置脚本执行的结果.每当脚本程序被startactivityforresult() 方法调用时 ,由此产生的intent 将会包含script_result 和给定的值 . setresultshortarray设置脚本被startactivityforresult() 方法调用后返回的短整型数组: setresultshortarray( integer resultcode: 回传给原始activity 的结果编码 , 常常是 result_canceled(0) 或者result_ok(-1), short resultvalue) 设置脚本执行的结果.每当脚本程序被startactivityforresult() 方法调用时 ,由此产生的intent 将会包含script_result 和给定的值 . setresultstring设置脚本被startactivityforresult() 方法调用后返回的字符串: setresultstring( integer resultcode: 回传给原始activity 的结果编码 , 常常是 result_canceled(0) 或者result_ok(-1), string resultvalue) 设置脚本执行的结果.每当脚本程序被startactivityforresult() 方法调用时 ,由此产生的intent 将会包含script_result 和给定的值 . setresultstringarray设置脚本被startactivityforresult() 方法调用后返回的字符串数组: setresultstringarray( integer resultcode: 回传给原始activity 的结果编码 , 常常是 result_canceled(0) 或者result_ok(-1), string resultvalue) 设置脚本执行的结果.每当脚本程序被startactivityforresult() 方法调用时 ,由此产生的intent 将会包含script_result 和给定的值 . cancelrepeating名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 10 页，共 47 页 - - - - - - - - - 取消脚本的定时执行计划: cancelrepeating( string script) 取消给定脚本所有的定时(重复 )执行计划scheduleabsolute定时执行传入的脚本，从开机后开始计时：scheduleabsolute( string script: 要执行的脚本, double time: 脚本延迟执行时间, 开机 (epoch?)后延迟一定时间执行脚本,延迟的时间由此参数指定boolean wakeupoptional, default true: 是否唤醒处于黑屏状态的移动设备) 定时执行传入的脚本,从开机后开始计时scheduleinexactrepeating每隔一段端时间执行一次脚本（时间间隔不太精确）scheduleinexactrepeating( double interval: 两次执行之间的时间间隔,以秒为单位string script: 要执行的脚本, boolean wakeupoptional, default true: 是否唤醒处于黑屏状态的移动设备) 从脚本被调用开始,每隔一段时间执行一次脚本(不是很精确 ),但是比schedulerepeating 方法省电schedulerelative定时执行脚本,延迟时间从方法被调用时开始计算schedulerelative( string script: 要执行的脚本, double secondsfromnow: 从现在起 ,延迟一定时间执行脚本,延迟时间由此参数指定boolean wakeupoptional, default true: 是否唤醒处于黑屏状态的移动设备) 从脚本被调用开始，延迟数秒钟后执行脚schedulerepeating每隔一段时间执行一次脚本（精确）schedulerepeating( double interval: 两次执行之间的时间间隔,以秒为单位string script: 要执行的脚本, double firstexecutiontimeoptional: 第一次执行脚本所需要延迟的时间,从开机 (epoch?)开始计算boolean wakeupoptional, default true: 是否唤醒处于黑屏状态的移动设备) 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 11 页，共 47 页 - - - - - - - - - 每隔一段时间执行一次脚本,从开机开始计算getclipboard读取剪贴板中的文本getclipboard() 从剪贴板中读取文本。返回值 : 剪贴板中的文本。getinput请求用户输入文本getinput( string title 可选 , 默认为sl4a inpu: 输入框的标题string messagek 可选 , 默认为please enter value: 输入框的提示信息) 请求用户输入文本信息已废弃，请使用dialoggetinput 方法替代。getintent获取启动脚本的intent getintent() 返回启动脚本的intent getpackageversion返回包的版本名getpackageversion( string packagename) 返回包的版本名getpackageversioncode返回包的版本号getpackageversioncode( string packagename) 返回包的版本号名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 12 页，共 47 页 - - - - - - - - - getpassword请求用户输入密码getpassword( string titleoptional, default 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: 标题 , string message) 显示一个通知，在用户点击后会取消。requiredversion检测版本信息requiredversion( integer requiredversion) 检测当前sl4a 的版本是否大于制定的版本。sendemail名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 13 页，共 47 页 - - - - - - - - - 发邮件sendemail( string to: 一系列的收件人列表，用逗号分隔。string subject, string body, string attachmenturi 可选 ) 启动一个发送邮件的activity ，将内容发送给接收者。setclipboard向剪贴板写入信息setclipboard( string text) 向剪贴板写入信息。startactivity启动一个activity startactivity( string action, string uri 可选 , string typek 可选 : uri 的 mime 类型 /子类型 , jsonobject extras 可选 : 要添加到 intent 的附加数据，以map 形式保存 , boolean wait 可选 : 阻塞当前应用知道打开的activity 被关闭 ) 启动一个activity startactivityforresult运行一个activity 并返回结果startactivityforresult( string action, string uri 可选 , string type 可选 : uri 的 mime 类型 /子类型 , jsonobject extras 可选 : 要添加到 intent 的附加数据，以map 形式保存 ) 运行一个activity 并返回结果返回 : 最终的 intent,以 map 形式呈现vibrate震动vibrate( integer duration 可选 , 默认为300: 持续时间 ,以毫秒为单位 ) 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 14 页，共 47 页 - - - - - - - - - 使手机震动指定的时间。forcestoppackage强制终止一个包forcestoppackage( string packagename: 包名 ) 强制终止一个包。getlaunchableapplications获得可运行的应用getlaunchableapplications() 返回一个可以运行的应用类名列表getrunningpackages返回正在运行的activity 或者服务的列表getrunningpackages() 返回一个正在运行的activity 或者服务的列表。返回 : 一个正在运行activity 的列表。launch启动一个activity launch( string classname) 按照给定的类名启动一个activity 。batterycheckpresent查看电池电量信息: batterycheckpresent() 返回当前的电池电量信息需要api level 5. batterygethealth查看电池健康状态: batterygethealth() 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 15 页，共 47 页 - - - - - - - - - 返回当前的电池健康状态信息: 1 - 未知 ; 2 - 良好 ; 3 - 过热 ; 4 - 不可用 ; 5 - 电量过饱 ; 6 - 查询失败 ; batterygetlevelbatterygetlevel() 返回电池电量(百分比形式 ) 需要api level 5. batterygetplugtype返回充电状态信息batterygetplugtype() 返回充电电源信息-1 - 未知 ; 0 - 为插入电源 ; 1 - 交流电源充电; 2 - usb 充电batterygetstatus返回充电状态信息batterygetstatus() 返回充电状态信息1 - 未知 ; 2 - 充电中 ; 3 - 放电中 ; 4 - 为充电 ; 5 - 已充满 ; batterygettechnologybatterygettechnology() 返回电池技术数据需要api level 5. 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 16 页，共 47 页 - - - - - - - - - batterygettemperature返回电池温度batterygettemperature() 返回当前电池的温度. 需要api level 5. batterygetvoltage返回电池的电压batterygetvoltage() 返回当前电池的电压. 需要api level 5. batterystartmonitoring开始监视电池状态batterystartmonitoring() 开始监视电池状态. 触发battery 事件 . batterystopmonitoring停止监视电池状态batterystopmonitoring() 停止监视电池状态readbatterydata读取电池记录数据readbatterydata() 读取当前记录的电池数据bluetoothaccept监听并接受一个蓝牙连接bluetoothacc