DroidScript

Объект приложения

DroidScript
инструменты разработки под Android

Объект приложения

Объект приложения app является основным и главным объектов DroidScript API. Он создаётся автоматически при создании приложения и освобождается автоматически при закрытии приложения. Конструктор объекта называется App.

Объект приложения реагирует на следующие системные события:

  • OnStart - создание приложения
  • OnMenu - выбор элемента всплывающего меню приложения
  • OnDrawer - выдвигается или задвигается выдвижное меню
  • OnBack - нажатие на системную кнопку Back (при выключенном её действии по умолчанию методом app.EnableBackKey(false))
  • OnPause - приостановка работы приложения (в том числе, при переключении на домашний экран)
  • OnResume - возобновление приостановленного приложения (в том числе, при переключении из домашнего экрана)
  • OnConfig – изменение конфигурации (в том числе при повороте устройства пользователем)
  • OnAlarm - сигнал будильника (если будильник был включен ранее методом app.SetAlarm())
  • OnData – отправка данных сторонними приложениями

Для задания действия при возникновении этих событий используются одноимённые функции.

Базовый пример

Выполнить в DS

Пример обработки событий

Выполнить в DS

Методы:

  • AddDrawer( {} layout, ('left','right') side, float width, float grabWidth) - добавляет слой выдвижного меню, с указанием места его появления, ширины и ширины области захвата
    Выполнить в DS
    app.AddDrawer( myLay, 'left', 0.75, 0.1);
  • AddLayout( {} layout ) - добавляет компоновщик
    Выполнить в DS
    app.AddLayout( myLayout );
  • Alert( str msg, str title, [(str)] options, int hue ) - вызывает диалог сообщения:
    • msg - текст сообщения
    • title - текст заголовка
    • options - опции ('NoDim' - не затенять приложение)
    • hue - цвет заголовка и линии
    Выполнить в DS
    app.Alert( 'Текст сообщения', 'Заголовок', 'NoDim', 0.75);
  • Animate( callback, int fps ) - используется как альтернатива методу setInterval для получения более плавной анимации с заданной частотой кадров

  • Broadcast( str type, str msg ) - не документировано

  • BroadcastIntent( action,category,data,type,extras ) - не документировано

  • Call( str number ) - осуществляет вызов телефонного номера
    Выполнить в DS
    app.Call();
  • CheckLicense( key ) - осуществляет проверку лицензии Google Play при запуске платного приложения. Если приложение не имеет лицензии (кто-то достал копию apk и установил её), то появится диалог с просьбой купить его в GooglePlay, а затем приложение закроется
    Выполнить в DS
    app.CheckLicense();
  • ChooseContact( ("phone") type, callback ) - открывает диалог для выбора контакта и возвращает его в функцию обратного вызова
    Выполнить в DS
    app.ChooseContact();
  • ChooseFile( str msg, (str) type, callback ) - открывает диалог для выбора файлового менеджера, с помощью которого можно выбрать файлы заданного типа и получить их в функциии обратного вызова. Можно указать следующие типы type:
    • "audio/*" - аудиофайлы
    • "text/*" - текстовые файлы
    • "image/*" - файлы изображений
    • "*/*" - все файлы
    Выполнить в DS
    app.ChooseFile( 'Выбрать', 'image/*' , function( p_file ){ app.ShowPopup( p_file );} );
  • ClearCookies( str session ) - очищает куки
    Выполнить в DS
    app.ClearCookies();
  • ClearData( str file ) - очищает данные приватного файла ресурсов, записанные методами SaveNumber, SaveBool, SaveText
    Выполнить в DS
    app.ClearData();
  • CloseDrawer( ('left','right') side ) - закрывает выдвижное меню в заданную сторону
    Выполнить в DS
    app.CloseDrawer( 'left' );
  • CopyFile( str src, str dest ) - копирует файл из папки источника в папку назначения
    Выполнить в DS
    app.CopyFile( '/sdcard/test.txt', '/sdcard/DroidScript/test.txt' );
  • CopyFolder( str src, str dest, bool overwrite, str filter ) - копирует папку из папки источника в папку назначения без перезаписи или с перезаписью содержимого папки назначения
    Выполнить в DS
    app.CopyFolder( '/sdcard/myData', '/sdcard/DroidScript/myData', true );
  • CreateAudioRecorder():{} - создаёт объект для записи звука
  • CreateBluetoothList( str filter ):{} - создаёт диалог со списком доступных Bluetooth-устройств
  • CreateBluetoothSerial( ('hex') mode ):{} - создаёт объект для работы с Bluetooth. Режим 'hex' используется для установки обмена байтами (в шестнадцатеричном или десятичном формате)
  • CreateButton( str text, float width, float height, [(str)] options ):{} - создаёт кнопку
  • CreateCameraView( float width, float height, [(str)] options ):{} - создаёт объект для работы с камерой
  • CreateCheckBox( str text, float width, float height, [(str)] options ):{} - создаёт флажок
  • CreateCodeEdit( str text, float width, float height, [(str)] options ):{} - создаёт редактор кода (доступно для премиум-пользователей)
  • CreateCrypt( [(str)] options ):{} - создаёт криптограф
  • CreateDebug():{} - создаёт отладчик
    Выполнить в DS
    app.CreateDebug();
  • CreateDialog( str title, [(str)] options ):{} - создаёт пользовательский диалог
  • CreateDownloader( [(str)] options ):{} - создаёт загрузчик
  • CreateEmail( str account, str password ):{} - создаёт объект для работы с почтой
  • CreateFile( str file, (str) mode ):{} - создаёт файл и возвращает объект для работы с ним на низком уровне
  • CreateGLView( float width, float height, [(str)] options ):{} - создаёт холст для быстрой работы с двумерной графикой
  • CreateImage( str file, float width, float height, [(str)] options, float w, float h ):{} - создаёт холст для рисования и вывода графики
  • CreateLayout( ('linear','absolute','frame') type, [(str)] options ):{} - создаёт компоновщик заданного типа
  • CreateList( [str] list, float width, float height, [(str)] options ):{} - создаёт список
  • CreateListDialog( str title, [str] list, [(str)] options ):{} - создаёт диалог выбора опции списка
  • CreateListView( [str] list, str title, [(str)] options ):{} - создаёт полноэкранный список
  • CreateLocator( str type, [(str)] options ):{} - создаёт локатор
  • CreateMediaPlayer():{} - создаёт аудиопроигрыватель
  • CreateMediaStore():{} - создаёт объект для работы с хранилищем медиарисурсов
  • CreateNetClient( (str) type ):{} - создаёт сетевого клиента
  • CreateNotification( [(str)] options ):{} - создаёт уведомление
  • CreateNxt():{} - создаёт объект для работы с NXT-устройствами
  • CreateNxtRemote():{} - создаёт объект управления NXT-устройствами
  • CreateObject( str name ):{} - создаёт объект для загруженного в приложение плагина, имя которого задаётся в параметре
    Выполнить в DS
    app.CreateObject( 'MyPluginName' );
  • CreatePhoneState( str types ):{} - создаёт объект для прослушивания состояния телефона
  • CreatePlayStore():{} - создаёт объект для работы с магазином приложений Google
  • CreateSMS():{} - создаёт объект для работы с SMS-сообщениями
  • CreateScroller( float width, float height, [(str)] options ):{} - создаёт область прокрутки
  • CreateSeekBar( float width, float height, [(str)] options ):{} - создаёт горизонтальный ползунок
  • CreateSensor( (str) type, [(str)] options ):{} - создаёт объект для работы с заданным датчиком
  • CreateService( str packageName, str className, callback, [(str)] options ):{} - создаёт сервисную службу
  • CreateShortcut( str name, str iconFile, str file, [(str)] options ):{} - создаёт ярлык для приложения
  • CreateSmartWatch( (str) type ):{} - создаёт объект для работы с умными часами Sony
  • CreateSpeechRec( [(str)] options ):{} - создаёт объект для распознавания речи
  • CreateSpinner( [str] list, float width, float height, [(str)] options ):{} - создаёт выпадающий список
  • CreateSynth( (str) type ):{} - создаёт синтезатор звука
  • CreateSysProc( str cmd ):{} - создаёт объект для выполнения системных команд
  • CreateTabs( [] list, float width, float height, [(str)] options ):{} - создаёт объект для работы с вкладками
  • CreateText( str text, float width, float height, [(str)] options ):{} - создаёт текстовую область
  • CreateTextEdit( str text, float width, float height, [(str)] options ):{} - создаёт поле ввода
  • CreateTheme( (str) baseTheme ):{} - создаёт объект для работы с тематическим оформлением приложения (доступно только для премиум-пользователей)
  • CreateToggle( str text, float width, float height, [(str)] options ):{} - создаёт кнопку с фиксацией
  • CreateUSBSerial():{} - создаёт объект для работы c USB
  • CreateVideoView( float width, float height, [(str)] options ):{} - создаёт видеопроигрыватель
  • CreateWebGLView( float width, float height, [(str)] options ):{} - создаёт холст для быстрой работы с графикой в web
  • CreateWebServer( int port, [(str)] options ):{} - создаёт web-сервер
  • CreateWebSocket( str id, str ip, int port, [(str)] options ):{} - создаёт web-сокет
  • CreateWebView( float width, float height, [(str)] options, int zoom ):{} - создаёт браузер
  • CreateYesNoDialog( str msg, [(str)] options ):{} - создаёт диалог подтверждения/отмены действия
  • CreateZipUtil( mode ):{} - создаёт архиватор
  • Debug( str msg ) - создаёт сообщение для отображения в окне отладчика
    Выполнить в DS
    app.Debug( 'Создали объект' );
  • DeleteDatabase( str name ) - удаляет базу данных
    Выполнить в DS
    app.Deletebase( 'mybase' );
  • DeleteFile( str file ) - удаляет файл
    Выполнить в DS
    app.DeleteFile( '/sdcard/myfile.txt' );
  • DeleteFolder( str fldr ) - удаляет папку
    Выполнить в DS
    app.DeleteFile( '/sdcard/myfolder' );
  • DestroyDrawer( {} layout ) - освобождает компоновщик выдвижного меню
    Выполнить в DS
    app.DestroyDrawer( menu );
  • DestroyLayout( {} layout ) - освобождает компоновщик
    Выполнить в DS
    app.DestroyLayout( layMain );
  • DisableKeys( ([str]) keyList ) - запрещает обычное действие (по умолчанию) для заданных клавиш
    Выполнить в DS
    app.DisableKeys( 'ENTER, TAB' );
  • DiscoverBtDevices( str filter, onFound, onComplete ) - обнаруживает устройства Bluetooth
  • DownloadFile( str src, str dest, str title, str desc, [(str)] options ) - загружает файл, используя встроенный в Android загрузчик
    Выполнить в DS
    app.DownloadFile( src, '/sdcard/speedtest.zip', 'Проверка скорости', '50 MB файл' );
  • EnableBackKey( bool enable ) - управляет поведением системной клавиши Back. Если установлено false, то вместо стандартного поведения будет вызвана функция приложения onBack
    Выполнить в DS
    app.EnableBackKey( false );
  • Execute( str js ) - выполняет строку как JavaScript-код
    Выполнить в DS
    app.Execute( 'alert( "Привет'" )' );
  • Exit( kill ) - завершает выполнение программы
    Выполнить в DS
    app.Exit();
  • ExtractAssets( str src, str dest, bool overwrite ) - копирует необходимые для работы приложения файлы из одной папки в другую с перезаписью при overwrite = true
    Выполнить в DS
    app.ExtractAssets( '/sdcard/srcfolder', '/sdcard/destfolder', false );
  • FileExists( str file ):bool - проверяет существование заданного файла
    Выполнить в DS
    app.ShowPopup( app.FileExists( '/sdcard/myPicture.png' ));
  • FolderExists( str fldr ):bool - проверяет существование заданной папки
    Выполнить в DS
    app.ShowPopup( app.FolderExists( '/sdcard/Download' ));
  • GetAccounts():[{}] - возвращает информацию об учётных записях
    Выполнить в DS
    app.ShowPopup( app.GetAccounts( ));
  • GetActivities( options )[{str label, str packageName, str className}] - возвращает информацию об активностях
    Выполнить в DS
    alert( JSON.stringify(app.GetActivities(),null,1) );
  • GetAppName():str - возвращает имя выполняющегося приложения
    Выполнить в DS
    app.ShowPopup( app.GetAppName() );
  • GetAppPath():str - возвращает путь до выполняющегося приложения
    Выполнить в DS
    app.ShowPopup( app.GetAppPath() );
  • GetBatteryLevel():float - возвращает уровень заряда батареи (0..1)
    Выполнить в DS
    app.ShowPopup( app.GetBatteryLevel() );
  • GetBluetoothAddress:str- возвращает адрес Bluetooth
    Выполнить в DS
    app.ShowPopup( app.GetBluetoothAddress() );
  • GetBluetoothName():str - возвращает имя Bluetooth-устройства
    Выполнить в DS
    app.ShowPopup( app.GetBluetoothName() );
  • GetBtProfileState( (str) type):(str) - возвращает состояние соединения Bluetooth. type - 'a2dp','headset', 'gatt' или 'health'.
    Выполнить в DS
    app.ShowPopup( app.GetBtProfileState('health') );
  • GetBuildNum():int - возвращает номер уровня API Android
    Выполнить в DS
    app.ShowPopup( app.GetBuildNum() );
  • GetChargeType():str - возвращает тип заряжающего устройства или 'None' при его отсутствиии
    Выполнить в DS
    app.ShowPopup( app.GetChargeType() );
  • GetClipboardText():str - возвращает текст из буффера обмена
    Выполнить в DS
    app.ShowPopup( app.GetClipboardText() );
  • GetCountry():str - возвращает страну
    Выполнить в DS
    app.ShowPopup( app.GetCountry() );
  • GetCountryCode() - возвращает код страны
    Выполнить в DS
    app.ShowPopup( app.GetCountryCode() );
  • GetDSVersion():float - возвращает номер версии DroidScript
    Выполнить в DS
    app.ShowPopup( app.GetDSVersion() );
  • GetData( str name ):[] - возвращает пользовательские данные
    Выполнить в DS
    app.ShowPopup( app.GetData( 'test' ));
  • GetDatabaseFolder():str - возвращает папку базы данных
    Выполнить в DS
    app.ShowPopup( app.DatabaseFolder() );
  • GetDefaultOrientation():(str) - возвращает ориентацию устройства, заданную по умолчанию - 'Portrait' или 'Landscape'
    Выполнить в DS
    app.ShowPopup( app.GetDefaultOrientation() );
  • GetDeviceId():str - возвращает идентификатор устройства
    Выполнить в DS
    app.ShowPopup( app.GetDeviceId() );
  • GetDisplayHeight():int - возвращает высоту экрана в px (исключается высота верхнего и нижнего информационного поля)
    Выполнить в DS
    app.ShowPopup( app.GetDisplayHeight() );
  • GetDisplayWidth():int - возвращает ширину экрана в px
    Выполнить в DS
    app.ShowPopup( app.GetDisplayWidth() );
  • GetEnv( str name ):[] - возвращает переменные окружения
    Выполнить в DS
    app.ShowPopup( app.GetEnv() );
  • GetExternalFolder():str - возвращает путь до папки внешнего хранилища данных устройства
    Выполнить в DS
    app.ShowPopup( app.GetExternalFolder() );
  • GetFileDate( str file ):[] - возвращает дату создания/изменения файла
    Выполнить в DS
    app.GetFileDate( '/sdcard/DroidScript/index.html' );
  • GetFileSize( str file ):float - возвращает размер файла в байтах
    Выполнить в DS
    >app.GetFileSize( '/sdcard/DroidScript/index.html' );
  • GetFreeSpace( ('internal','external') mode ):float - возвращает свободное пространиство внутреннего или внешнего хранилища устройства в Gb
    Выполнить в DS
    app.ShowPopup( app.GetFreeSpace() );
  • GetIPAddress():str - возвращает IP-адресс устройства
    Выполнить в DS
    app.ShowPopup( app.GetIPAdress() );
  • GetInstalledApps():[{}] - возвращает информацию об установленных приложениях в следующих полях:
    • str packageName - имя пакета
    • str className - имя класса
    • uid - идентификатор
    • int targetSDKVersion - целевая версия платформы Android
    • str dataDir - папка данных
    • str sourceDir - путь к apk-файлу
    • str publicSourceDir - общедоступный путь к apk-файлу
    • str nativeLabraryDir - путь к папке с библиотеками
    Выполнить в DS
    alert( JSON.stringify(app.GetInstalledApps(),null,1 ));
  • GetIntent():{action, type, data, extras} - возвращает параметры намерения
    Выполнить в DS
    app.ShowPopup( app.GetIntent() );
  • GetInternalFolder():str - возвращает путь до внутренного хранилища данных устройства
    Выполнить в DS
    app.ShowPopup( app.GetInternalFolder() );
  • GetJoystickName( float id ):str - возвращает имя джойстика, подключённого к через OTG-кабель
    Выполнить в DS
    app.ShowPopup( app.GetJoystickName() );
  • GetJoystickState( int id, (str) key ):float - возвращает состояние кнопки джойстика :
    • 0 - кнопка не нажата
    • 1 - кнопка нажата
    • -1.0 ... 1.0 - для устройств с действиями по осям (например, -1.0 для оси X - влево, 1.0 - для оси X - вправо)
    • key - кнопка ( могут быть от 'axis-0' до 'axis-9'):
      • 'Up' - верхняя
      • 'Down' - нижняя
      • 'Left' - левая
      • 'Right' - правая
      • 'Center' - центральная
      • 'X','Y','Z' - осевые
      • 'A','B','C' - функциональные
      • 'Start' - старта
      • 'ThumbLeft' - большая левая
      • 'ThumbRight' - большая правая
      • 'l1','r1','l2','r2'
    Выполнить в DS
    app.ShowPopup( app.GetJoystickState( 0, 'A' ));
  • GetKeyboardHeight():float - возвращает высоту области виртуальной клавиатуры
    Выполнить в DS
    app.ShowPopup( app.GetKeyboardHeight() );
  • GetLanguage():str - возвращает название языка локализации
    Выполнить в DS
    app.ShowPopup( app.GetLanguage() );
  • GetLanguageCode():str -возвращает код локализации
    Выполнить в DS
    app.ShowPopup( app.GetLanguageCode() );
  • GetLastButton():{} - возвращает нажатую последней кнопку
    Выполнить в DS
    app.ShowPopup( app.GetLastButton() );
  • GetLastCheckBox():{} - возвращает нажатый последним флажок
    Выполнить в DS
    app.ShowPopup( app.GetLastCheckBox() );
  • GetLastImage():{} - возвращает нажатый последним холст (картинку)
    Выполнить в DS
    app.ShowPopup( app.GetLastImage() );
  • GetLastToggle():{} - возвращает нажатую последней кнопку с фиксацией
    Выполнить в DS
    app.ShowPopup( app.GetLastToggle() );
  • GetMacAddress():str - возвращает MAC-адрес устройства
    Выполнить в DS
    app.ShowPopup( app.GetMacAddress() );
  • GetMediaFile( str appName, str ext ) - не документировано. Создаёт в папке sdcard0/Pictures папку с заданным в appName именем и расширением, заданным в ext

  • GetMemoryInfo():{int avail, bool low, int threshold, int total} - возвращает информацию об использовании памяти в байтах
    Выполнить в DS
    app.ShowPopup( JSON.stringify( app.GetMemoryInfo()) );
  • GetMetadata( str file, keys ) - не документировано

  • GetModel():str - возвращает модель устройства
    Выполнить в DS
    app.ShowPopup( app.GetModel() );
  • GetName():str - возвращает имя приложения
    Выполнить в DS
    app.ShowPopup( app.GetName() );
  • GetNotifyId():str - возвращает идентификатор уведомления
    Выполнить в DS
    app.ShowPopup( app.NotifyId() );
  • GetOSVersion():int - возвращает номер операционной системы
    Выполнить в DS
    app.ShowPopup( app.GetOSVersion() );
  • GetObjects():[{}] - возвращает массив идентификаторов объектов приложения
    Выполнить в DS
    app.ShowPopup( app.GetObjects() );
  • GetOptions() - возвращает опции приложения ('remote')
    Выполнить в DS
    app.ShowPopup( app.GetOptions() );
  • GetOrientation():(str) - возвращает текущую ориентацию экрана устройства
    Выполнить в DS
    app.ShowPopup( app.GetOrientation() );
  • GetPackageName():str - возвращает имя установочного пакета приложения
    Выполнить в DS
    app.ShowPopup( app.GetPackageName() );
  • GetPairedBTDevices():[] - возвращает массив индексов спаренных устройств
    Выполнить в DS
    app.ShowPopup( app.GetPairedBTDevices() );
  • GetPath():str - возвращает путь к папке приложения
    Выполнить в DS
    app.ShowPopup( app.GetPath() );
  • GetPrivateFolder( str name ):str - создаёт и возвращает путь до личной папки, доступной только для данного приложения
    Выполнить в DS
    app.ShowPopup( app.GetPrivateFolder( 'personalfolder' ));
  • GetResourceId( str name, [(str)] options ):int - возвращает идентификатор ресурса
    Выполнить в DS
    app.ShowPopup( app.GetResourceId() );
  • GetRingerMode():(str) - возвращает режим работы сигнала вызова
    Выполнить в DS
    app.ShowPopup( app.GetRingerMode() );
  • GetRotation():(0, 90, 180, 270) - возвращает текущий угол поворота экрана устройства
    Выполнить в DS
    app.ShowPopup( app.GetRotation() );
  • GetRunningApps():[{int user, int pid, str name, bool foreground}] - возвращает информацию о выполняющихся в данный момент времени приложениях
    Выполнить в DS
    alert( JSON.stringify(app.GetRunningApps(),null,1) );
  • GetRunningServices():[{int user, int pid, str name}] - возвращает информацию о выполняющихся в данный момент времени сервисах (процессах)
    Выполнить в DS
    alert( JSON.stringify(app.GetRunningServices(),null,1 ));
  • GetSSID():str - возвращает идентификатор (название) сети
    Выполнить в DS
    app.ShowPopup( app.GetSSID() );
  • GetScreenDensity():int - возвращает плотность пикселов экрана устройства
    Выполнить в DS
    app.ShowPopup( app.GetScreenDensity() );
  • GetScreenHeight( 'Real' options ):int - возвращает клиентскую высоту экрана (исключается высота ActionBar) в px и полную высоту, при заданной опции 'real'
    Выполнить в DS
    app.ShowPopup( app.GetScreenHeight( 'real' ));
  • GetScreenWidth( 'Real' options ):int - возвращает ширину экрана в px и реальную ширину, при заданной опции 'real'
    Выполнить в DS
    app.ShowPopup( app.app.GetScreenWidth() );
  • GetSharedFiles():[] - возвращает список совместно используемых файлов
    Выполнить в DS
    app.ShowPopup( app.GetSharedFiles() );
  • GetSharedText( index ):str - возвращает список совместно используемого текста
    Выполнить в DS
    app.ShowPopup( app.GetSharedText( 0 ) );
  • GetSpeakerPhone():bool - возвращает состояние включен/выключен динамика телефона
    Выполнить в DS
    app.ShowPopup( app.GetSpeakerPhone());
  • GetSpecialFolder( str name ):str - возвращает путь до заданной системной папки, напрмер, 'DCIM', 'Moves', 'Pictires', 'Downloads' и т.п.
    Выполнить в DS
    app.ShowPopup( app.GetSpecialFolder( 'Moves' ));
  • GetThumbnail( str src, str dest, int width, int height ):{} - возвращает миниатюрные изображения фотографий
    Выполнить в DS
    app.ShowPopup( app.GetThumbnail() );
  • GetTop():float - возвращает y-координату области приложения
    Выполнить в DS
    app.ShowPopup( app.GetTop() );
  • GetType():(str) - возвращает тип объекта
    Выполнить в DS
    app.ShowPopup( app.GetType() );
  • GetUser():str - возвращает электронный адрес учетной записи
    Выполнить в DS
    app.ShowPopup( app.GetUser() );
  • GetVersion():float - возвращает номер версии приложения
    Выполнить в DS
    app.ShowPopup( app.GetVersion() );
  • GetVolume( (str) stream ):float - возвращает уровень громкости (0..1) для воспроизведения заданного потока:
    • 'music' - музыка
    • 'alarm' - будильник
    • 'notification' - уведомление
    • 'system' - системный звук
    • 'ring' - рингтон (сигнал вызова абонента)
    • 'dtmf' - тональный сигнал (при наборе телефонного номера)
    • 'voicecall' - голосовой вызов
    • 'other' - прочее
    Выполнить в DS
    app.ShowPopup( app.app.GetVolume( 'music' ));
  • HasSoftNav():bool - проверяет, имеет ли приложение программную строку навигации
    Выполнить в DS
    app.ShowPopup( app.HasSoftNav() );
  • HideKeyboard( bool hide ) - задаёт режим видимости клавиатуры
    Выполнить в DS
    app.HideKeyboard( false );
  • HideProgress() - скрывает значёк прогресса при загрузке
    Выполнить в DS
    app.HideProgress();
  • HideProgressBar() - скрывает панель прогресса загрузки
    Выполнить в DS
    app.HideProgressBar();
  • HttpRequest( (str) type, (srt) baseUrl, (str) path, params, callback, headers ) - выполняет запрос (полезно использовать для обхождения проблем кросс-доменных запросов)
    Выполнить в DS
    app.HttpRequest( "get", "http://maps.googleapis.com", "/maps/api/directions/json",
    "origin=Toronto|destination=Montreal|avoid=highways|mode=bicycling", OnHttpResult );
  • IsAPK():bool - проверяет, является ли приложение автономно исполняемым
    Выполнить в DS
    app.ShowPopup( app.IsAPK());
  • IsAppInstalled( str packageName ):bool - проверяет, установлено ли заданное приложение
    Выполнить в DS
    app.ShowPopup( app.IsAppInstalled());
  • IsBluetoothEnabled():bool - проверяет, оснащено ли устройство Bluetooth
    Выполнить в DS
    app.ShowPopup( app.IsBluetoothEnabled());
  • IsBluetoothOn():bool - проверяет, включен ли Bluetooth
    Выполнить в DS
    app.ShowPopup( app.IsBluetoothOn());
  • IsBtDevicePaired( str name ):bool - проверяет, спарено ли Bluetooth-устройство с заданным именем
    Выполнить в DS
    app.ShowPopup( app.IsBtDevicePaired( 'HC-06' ));
  • IsChargins():bool - проверяет, заряжается ли устройство
    Выполнить в DS
    app.ShowPopup( app.IsChargins());
  • IsChrome():bool - проверяет, является ли операционная система устройства системой Chrome
    Выполнить в DS
    app.ShowPopup( app.IsChrome());
  • IsConnected():bool - проверяет подключение к сети
    Выполнить в DS
    app.ShowPopup( app.IsConnected());
  • IsEngine():bool - проверяет, является ли устройство двигателем
    Выполнить в DS
    app.ShowPopup( app.IsEngine());
  • IsFolder( str fldr ):bool - проверяет, указывает ли заданный путь на папку
    Выполнить в DS
    app.ShowPopup( app.IsFolder());
  • IsKeyboardShown():bool - проверяет, отображается ли на экране в данное время виртуальная клавиатура
    Выполнить в DS
    app.ShowPopup( app.IsKeyboardShown());
  • IsLocationEnabled( ('GPS','Network') types):bool - сообщает, есть ли возможность на устройстве использовать систему навигации GPS, Network или обеих.
    Выполнить в DS
    app.ShowPopup( app.IsLocationEnabled('GPS'));
  • IsNewVersion():bool - сообщает, устанавливается ли данная версия приложения впервые
    Выполнить в DS
    app.ShowPopup( app.IsNewVersion());
  • IsPremium():bool - проверяет, является ли пользователь привилегированным (действует при работе внутри IDE)
    Выполнить в DS
    app.ShowPopup( app.IsPremium());
  • IsScreenOn():bool - проверяет, включен ли экран устройства
    Выполнить в DS
    app.ShowPopup( app.IsScreenOn());
  • IsService():bool - проверяет, яляется ли приложение службой
    Выполнить в DS
    app.ShowPopup( app.IsService());
  • IsTablet():bool - проверяет, является ли устройство планшетом
    Выполнить в DS
    app.ShowPopup( app.IsTablet());
  • IsThings():bool - проверяет, является ли устройство платформой для интернета вещей
    Выполнить в DS
    app.ShowPopup( app.IsThings());
  • IsWifiEnabled():bool - проверяет, оснащено ли устройство Wifi
    Выполнить в DS
    app.ShowPopup( app.IsWifiEnabled());
  • KillApp( str procId ) - освобождает заданное идентификатором процесса приложение
    Выполнить в DS
    app.KillApp();
  • ListFolder( str path, str filter, int limit, ('fillPath, alphasort') options ):[] - возвращает список файлов указанной директории:
    • path - путь папки
    • filter - фильтр
    • limit - числовое ограничение количества возвращаемых записей
    • options:
      • fillPath - возвращать полные пути
      • alphsort - сортировка по алфавиту
      • Regex - регулярное выражение
      • FilesOnly - только файлы
      • FoldersOnly - только папки
    Выполнить в DS
    app.ListFolder( '/sdcard/', 'mp4', 10 );
  • LoadBoolean( str name, bool dflt, str file ) - загружает из указанного файла ресурс с булевым значением. Значение по умолчанию задаётся в параметре dflt
    Выполнить в DS
    app.LoadBoolean();
  • LoadNumber( str name, float dflt, str file ) - загружает из файла ресурс с числововым значением. Значение по умолчанию задаётся в параметре dflt
    Выполнить в DS
    app.LoadNumber();
  • LoadPlugin( str url ) - загружает плагин
    Выполнить в DS
    app.AddPlugin();
  • LoadScript( str url, callback ) - загружает скрипт. Функция обратного вызова вызывается после окончания загрузки
    Выполнить в DS
    app.LoadScript();
  • LoadText( str name, str dflt, str file ) - загружает из приватного файла ресурс со строковым значением. Значение по умолчанию задаётся в параметре dflt
    Выполнить в DS
    app.LoadText();
  • LockDrawer( (str) side ) - блокирует выдвигание выдвижного меню с заданной стороны (слева или справа)
    Выполнить в DS
    app.LockDrawer( ('left');
  • MakeFolder( str fldr ) - создаёт новую папку
    Выполнить в DS
    app.MakeFolder( '/sdcard/newFolder' );
  • Odroid( p1,p2,p3 ) - не документировано. (Odroid - Южно-Корейский одноплатный компьютер от Hardkernel Co., Ltd.)

  • OpenDatabase( str name ) - открывает базу данных
    Выполнить в DS
    app.OpenDatabase( 'myBase' );
  • OpenDrawer( (str) side ) - отобразить выдвигающееся меню с левой или правой стороны
    Выполнить в DS
    app.OpenDrawer( 'left' );
  • OpenFile( str file, (str) type, str choose ) - открывает файл в редакторе по умолчанию или диалог для выбора программы, в которой нужно открыть файл. В параметре chooseможно задать заголовок диалога
    Выполнить в DS
    app.OpenFile('/sdcard/my.htm','text/html', 'Выберите редактор' );
  • OpenUrl( str url, (str) type, choose ) - открывает ресурс по заданному адресу во внешнем браузере
    Выполнить в DS
    app.OpenUrl( 'http://ya.ru' );
  • PairBtDevice( str address, callback ) - спаривает устройство с заданным адресом и результат операции передаётся в ФОВ
    Выполнить в DS
    app.PairBtDevice( '01:13:B4:61:93:A3', function( p_result){ alert(p_tesult); } );
  • PlayRingtone( ('Alarm', 'Notification', 'Ringtone') type ) - проигрывает рингтон заданного типа
    Выполнить в DS
    app.PlayRingtone( 'Alarm' );
  • PreventScreenLock( bool mode ) - предотвращает блокировку экрана (true)
    Выполнить в DS
    app.PreventScreenLock( true );
  • PreventWifiSleep() - предотвращает переход службы WiFiв спящий режим
    Выполнить в DS
    app.PreventWifiSleep( true );
  • QueryContent( uri, columns, select, args, sort ) - запрашивает данные из ресурса c указанным uri
    Выполнить в DS
    var dayFrom = new Date().getTime() - 1000 * 60 * 60 * 24 * 30; var dayTo = new Date().getTime() + 1000 * 60 * 60 * 24 * 30; var uri = 'content:\/\/com.android.calendar/instances/when/'+dayFrom+'/'+dayTo; var select = null, params=null; var columns = 'title, begin, end, allDay,description,eventLocation'; rows = app.QueryContent( uri, columns, select, params ); alert( JSON.stringify(rows,null,1) );
  • ReadFile( str file, 'base64' encoding ) - производит чтение файла с возможным указанием кодировки (считывает двоичные данные в base64 строку)
    Выполнить в DS
    app.ReadFile();
  • RemoveDrawer( {} layout ) - удаляет компоновщик выдвижногно меню
    Выполнить в DS
    app.RemoveDrawer( myLayoutDrawer );
  • RemoveLayout( {} layout ) - удаляет компоновщик
    Выполнить в DS
    app.RemoveLayoput( myLayout );
  • RenameFile( str src, str dest ) - переименовывает файл
    Выполнить в DS
    app.RenameFile();
  • RenameFolder( str src, str dest ) - переименовывает папку
    Выполнить в DS
    app.RenameFolder();
  • SaveBoolean( str name, bool value, str file ) - сохраняет в файле ресурс с булевым значением
    Выполнить в DS
    app.SaveBoolean( 'myBoolean', true, '/sdcard/test.txt' );
  • SaveCookies() - сохраняет куки
    Выполнить в DS
    app.SaveCookies();
  • SaveNumber( str name, float value, str file ) - сохраняет в файле ресурс с числовым значением
    Выполнить в DS
    app.SaveNumber( myNumber, 25, myPrivateFile );
  • SaveText( str name, value, str file ) - сохраняет в приватный файл приложения ресурс со строковым значением
    Выполнить в DS
    app.SaveTest( myText, 'Строка текста', myPrivateFile );
  • ScanFile( str file ) - добавляет медиафайл в галерею устройства
    Выполнить в DS
    app.ScanFile();
  • SendFile( str file, str subject, str text, str choose ) - отправляет совместно используемый файл
    Выполнить в DS
    app.SendFile();
  • SendIntent( str packageName, str className, str action, str category, str uri, type, extras, (str) options, callback ) - отправляет намерение
    Выполнить в DS
    app.SendIntent('com.whatsapp','com.whatsapp.Main','android.intent.action.VIEW');
  • SendMail( str address, str subject, str body, {} attach ) - отправляет почтовое сообщение из доступного email аккаунта
    Выполнить в DS
    app.SendMail( 'test@gmail.com', 'MySubject', 'Hello', '/sdcard/file.txt' );
  • SendMessage( str msg ) - отправляет сообщение главному приложению из сервиса
    Выполнить в DS
    app.SendMessage(JSON.stringify({"item":"телефон","model":"Sumsung"}));
  • SendText( str text, str subject, str choose ) - отправляет совместно используемый текст
    Выполнить в DS
    app.SendText('Привет!');
  • SetAlarm( (str) type, int id, callback, int time, int interval, [(str)] options ) - устанавливает будильник с заданными параметрами
    Выполнить в DS
    app.SetAlarm( 'Repeat', 4321, OnAlarm, Date.now + 3000, 10000 );
  • SetAutoBoot( {} auto ) - задаёт режим автозагрузки DroidScript при включении устройства (используется при работе с устройствами без монитора). Значение может быть true, false, а также 'Service' для автозапуска служб
    Выполнить в DS
    app.SetAutoBoot( true );
  • SetAutoStart( str appName ) - задаёт режим автовыполнения выбранного приложения
    Выполнить в DS
    app.SetAutoStart( true );
  • SetAutoWifi( bool auto ) - задаёт команду DroidScript включать Wifi-редактор автоматически (для работы с устройствами без монитора)
    Выполнить в DS
    app.SetAutoWifi( true );
  • SetBackColor( str clr ) - задаёт цвет фона области приложения
    Выполнить в DS
    app.SetBackColor( '#ff666666' );
  • SetBluetoothEnabled( bool enable ) - включает/выключает Bluetooth
    Выполнить в DS
    app.SetBluetoothEnabled( true );
  • SetClipboardText( str txt ) - копирует текст в буффер обмена
    Выполнить в DS
    app.SetClipboardText( 'Текст для копирования' );
  • SetData( str name, value ) - записывает данные в пользовательскую память
    Выполнить в DS
    app.SetData( 'myUserData', 'Hello' );
  • SetDebugEnabled( bool enable ) - включает/выключает вывод в журнал событий отладочной информации
    Выполнить в DS
    app.SetDebugEnabled( true );
  • SetJoystickOptions( options ) - задат параметры джойстика
    Выполнить в DS
    app.SetJoystickOptions();
  • SetKioskMode( (str) mode, bool enable, [(str)] options ) - задаёт параметры при работе приложения в режиме "Киоск" (данный метод доступен только премиум-пользователям)
    Выполнить в DS
    app.SetKioskMode( "Status,Nav", true, "Black");
  • SetMenu( [str] list, str iconPath ) - задаёт опции для всплывающего меню приложения
    Выполнить в DS
    app.SetMenu( 'Новый','Открыть','Сохранить','Выйти' );
  • SetOnBroadcast( callback ) - задаёт ФОВ для получения широковещательных сообщений
    Выполнить в DS
    app.SetOnBroadcast( function(){ app.ShowPopup( 'Сообщение' );} );
  • SetOnDebug( callback ) - задаёт ФОВ для отладки
    Выполнить в DS
    app.SetOnDebug( function(){ app.ShowPopup( 'Отладка' );} );
  • SetOnError( callback ) - задаёт ФОВ для получения сообщений об ошибках
    Выполнить в DS
    app.SetOnError( function(){ app.ShowPopup( 'Возникла ошибка' );} );
  • SetOnKey( callback ) - задаёт ФОВ для определения действий при нажатии на клавиши
    Выполнить в DS
    app.SetOnKey( function(){ app.ShowPopup( 'Нажата клавиша' );});
  • SetOnShowKeyboard( callback ) - задаёт ФОВ для определения действий при отображении программной клавиатуры
  • SetOnWifiChange( callback( str state, str ssid) ) - задаёт ФОВ для определения действий при изменении подключения к сети
    Выполнить в DS
    app.SetOnWifiChange( function( p_state, p_ssid){ app.ShowPopup( p_state + ', '+ p_ssid );});
  • SetOptions( (str) options ) - задаёт опции приложению:
    • touchmodal
    • notouch
    • nofocus
    • secure
    • showlocked
    • wakescreen
    • screenon
    Выполнить в DS
    app.SetOptions( 'screenon' );
  • SetOrientation( ('ReverseLandscape','ReversePortrait') orient, callback ) - задаёт ориентацию
    Выполнить в DS
    app.SetOrientation( 'ReverseLandscape' );
  • SetPosition( float left, float top, float width, float height, (str) options ) - задаёт положение и размеры области приложения
    Выполнить в DS
    app.SetPosition( 0.2, 0.2, 0.4, 0.3);
  • SetPriority( ('Low','Medium','High') level ) - задаёт приоритет потока
    Выполнить в DS
    app.SetPriority( 'Low');
  • SetRingerMode( ('Normal','Silent', 'Vibrate') mode ) - задаёт режим работы сигнала вызова - нормальный (звуковой), тишина, вибровызов
    Выполнить в DS
    app.SetRingerMode( 'vibrate' );
  • SetScreenBrightness( float level ) - задаёт уровень яркости экрана устройства от 0.0 до 1.0. Значение уровня -1 задаёт режим "Auto"
    Выполнить в DS
    app.SetScreenBrightness( 0.25 );
  • SetScreenMode( ('Full','Game','Normal') mode ) - задаёт режим работы экрана:
    • Full - app.GetScreenX и app.GetDisplayX возвращают одинаковые значения ширины и высоты, равные максимальному разрешению экрана
    • Game - аналогично Full, но убираются кнопки из системной панели навигации
    • Normal - app.GetScreenHeight возвращает доступную высоту экрана за вычитанием высоты системной панели навигации, a app.GetDisplayHeight возвращает непонятное отрицательное значение
    Выполнить в DS
    app.SetScreenMode( 'Full' );
  • SetSharedApp( str name ) - задаёт совместно используемое приложение
    Выполнить в DS
    app.SetSharedApp( myShwredApp );
  • SetSpeakerPhone( bool on ) - включает/выключает динамик телефона
    Выполнить в DS
    app.SetSpeakerPhone( true );
  • SetTheme( (str) theme ) - задаёть выбранную цветовую тему приложению (данный метод доступен только премиум-пользователям)
    Выполнить в DS
    app.SetTheme( 'Light' );
  • SetTitle( title ) - задаёт заголовок для приложения (устаревший метод, сейчас не используется)

  • SetUserAgent( str agent ) - задаёт клиентское приложение
    Выполнить в DS
    var agent = navigator.userAgent; agent = agent.replace(/Android/gi,'secret'); web.SetUserAgent( agent );
  • SetUserCreds( str name, str password ) - задаёт пользовательскую кредитку
    Выполнить в DS
    app.SetUserCreds();
  • SetVolume( (str) stream, float level ) - задаёт уровень громкости для воспроизведения потока, который может быть следующих типов:
    • alarm
    • dtmf
    • music
    • notification
    • ring
    • system
    • voicecall
    Выполнить в DS
    app.SetVolume( 'System', 0.5 );
  • SetWifiEnabled( bool enable ) - задаёт режим работы Wifi
    Выполнить в DS
    app.SetWifiEnabled( true );
  • ShowDebug( str show ) - выводит сообщение или результат работы выражения в отладочное окно. В качестве альтернативы можно использовать метод console.log. Сообщение может содержать HTML-теги
    Выполнить в DS
    app.ShowDebug('h1' + (1 + 1) + '' );
  • ShowKeyboard( {} obj ) - выводит на экран клавиатуру для заданного объекта. Используется для объектов, которые имеют метод Focus
    Выполнить в DS
    app.ShowKeyboard( myTextEdit );
  • ShowMenu() - отображает на экране всплывающее меню приложения
    Выполнить в DS
    app.ShowMenu();
  • ShowPopup( str msg, ('Bottom','Short') options ) - отображает на экране всплывающее сообщение:
    • Bottom - отображать внизу
    • Short - показывать сообщение на короткое время
    Выполнить в DS
    app.ShowPopup( 'Файл успешно сохранён!', 'Bottom' );
  • ShowProgress( str msg, [(str)] options ) - отображает на экране заданный текст и значок загрузки
    Выполнить в DS
    app.ShowProgress( 'Загрузка...' );
  • ShowProgressBar( str title, int percent ) - отображает на экране панель загрузки
    Выполнить в DS
    app.ShowProgressBar( 'Загрузка...' );
  • ShowTextDialog( str title, str dflt, callback ) - отображает диалог для ввода текста и передаёт введённое значение в ФОВ
    Выполнить в DS
    app.ShowTextDialog( 'Файл', 'Имя файла', function( p_input ){ app.ShowPopup( p_input ); });
  • ShowTip( str msg, float left. float top, int timeout, 'up' options ) - отображает подсказку в заданной координате и в течении заданного времени в мс. 'up' - отображать подсказку сверху
    Выполнить в DS
    app.ShowTip('Это подсказка', 0.1, 0.1, 3000, 'up');
  • SimulateKey( {} obj, str keyName, (str) modifiers, int pause ) - осуществляет эмуляцию нажатия на клавишу. Доступны следующие модификаторы:
    • SHIFT_ON
    • SHIFT_LEFT_ON
    • SHIFT_RIGHT_ON
    • CTRL_ON
    • CTRL_LEFT_ON
    • CTRL_RIGHT_ON
    • ALT_ON
    • ALT_LEFT_ON
    • ALT_RIGHT_ON
    • FUNCTION_ON
    • CAPS_LOCK_ON
    • NUM_LOCK_ON
    • SCROLL_LOCK_ON
    • SYM_ON
    Выполнить в DS
    app.SimulateKey( myEdit, 'C' , 'SHIFT_LEFT_ON' )
  • SimulateTouch( {} obj, float x, float y, ('Down','Up','Move') dir ) - осуществляет эмуляцию касания объекта
    Выполнить в DS
    app.SimulateTouch( txt_open, 0.5, 0.5, 'Down' );
  • Start() - запускает текущее приложение
    Выполнить в DS
    app.Start();
  • StartApp( str file, (str) options, intent ) - запускает указанное приложение
    Выполнить в DS
    app.StartApp( 'myApp.js' );
  • StartDebugServer() - запускает службу отладки
    Выполнить в DS
    app.StartDebugServer();
  • StartService( str packageName, str className ) - запускает работу сервиса
    Выполнить в DS
    app.StartService();
  • StopApp( str name ) - останавливает указанное приложение
    Выполнить в DS
    app.StopApp( 'game' );
  • StopService() - останавливает работу сервиса
    Выполнить в DS
    app.StopService();
  • SysExec( str cmd, ('NoRead','Log','NoErrors') options, int maxRead, int timeout ):str - выполняет системную команду с возможностью вывода лога в окне отладчика. В последних параметрах можно задать максимальное количеством строк вывода и время ожидания
    Выполнить в DS
    app.SysExec('top -m 10 >/sdcard/top.txt', 'NoRead');
  • TextToSpeech( str text, float pitch, float rate, callback, stream, (str) locale, engine ) - произносит заданный текст синтезатором речи:
    • text - текст
    • locale - название локали (языка)
    • engine - речевой движок (должен быть установлен для выбранной локали)
    Выполнить в DS
    app.TextToSpeech( 'Привет', 1, 1, null, 'ru_RU');
  • ToBack() - сворачивает приложение (отправляет в фоновый режим на задний план)
    Выполнить в DS
    app.ToBack();
  • Try( p1,p2,p3 ) - не документировано

  • Unlock() - снимает блокировку
    Выполнить в DS
    app.Unlock();
  • UnlockDrawer( ('left','right') side ) - снимает блокировку выдвижения выдвижного меню
    Выполнить в DS
    app.UnlockDrawer( 'right' );
  • UnpairBtDevice( str address, callback ) - распаривает Bluetooth-устройство с заданным адресом и передаёт результат операции в ФОВ
    Выполнить в DS
    app.UnpairBtDevice( '01:45:3C:91:65:5b', function( p_result ){ alert( p_result );} );
  • UnzipFile( str src, str dest ) - распаковывает файл из архива в указанную папку
    Выполнить в DS
    app.UnzipFile();
  • UpdateProgressBar( int percent ) - обновляет информацию о ходе загрузке в панели загрузки
    Выполнить в DS
    app.UpdateProgressBar( 50 );
  • UploadFile( str url, str file, str name, callback ) - загружает файл с удалённого ресурса
    Выполнить в DS
    app.UploadFile( 'http://mysite.html', '/sdcard/text.txt', 'game', on_down);
  • Uri2Path( str url ) - не документировано (вызывает ошибку)

  • Vibrate( [str] pattern ) - посылает на выполнение вибросигнал заданного шаблона. Формат шаблона 'пауза,вибрация'. Значения указываются в миллисекундах
    Выполнить в DS
    app.Vibrate( '0,100,30,100,50,300' );
  • Wait( secs ) - задаёт интервал ожидания в секундах (функцию не рекомендуется использовать, поскольку она блокирует выполнение основного потока выполнения приложения)
    Выполнить в DS
    app.Wait( 1 );
  • WakeUp() - выводит приложение из состояния сна
    Выполнить в DS
    app.WakeUp();
  • WiFiConnect( str ssid, str key ) - осуществляет беспроводное подключение к закрытой сети, с указанием её имени и пароля
  • WriteFile( str file, str text, ('append','ascii') mode, str encoding ) - производит запись, перезапись или добавления ('append') текста в файл
    Выполнить в DS
    app.WriteFile( '/sdcard/myfile.txt', 'Строка для записи в файл', 'append');
  • ZipFile( str src, str dest ) - запаковывает выбранный файл в заданный архивный файл
    Выполнить в DS
    app.ZipFile();
  • ZipFolder( str src, str dest ) - запаковывает выбранную папку в заданный архивный файл
    Выполнить в DS
    app.ZipFolder();
  • _Extract( p1 ) - не документировано
Оглавление 
© 2016 droidscript.ru admin@droidscript.ru