remotedroid 0.2.0 → 0.4.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8301a5580415c8ff56c7234afc06a753f8120a241a6fc55ec21f213d4fb3c547
-  data.tar.gz: 582b60289878929ad00789a14f5fe1b709a7642c02a8ef0fd3361d4e32d68e14
+  metadata.gz: 93065c866dfef9501613644d3f1ec4f18fd7ba5459c62645eb97bbdfb6069b89
+  data.tar.gz: 8ae132d997c1c7072383eb6878e757bbcc7deeb1241d783d261a2d4885bd0c42
 SHA512:
-  metadata.gz: c25071dc6b9c5e2089453e0b90b0506d8a1990fe64619437c65642b32150ed50f6ab0ea89d5dfde0a858fe394bd8c804d83ee2acf58c6e04597dc27a807f1360
-  data.tar.gz: 373ca3e9621934a9257b89c3bd1d860a86c54921927a2028846577d6a1baa200ca778605d8a9120f59dcae73b0805e13a11205dabc0a3ff743ed6f8a802ddb54
+  metadata.gz: 548cc195f2f8525be869c8429dbb1ede8c9da42ba3ff489b347b204f2bdcb630e09b5d012b4c496ff49bcd2ec6d94bccfc968ff9d4cfbe4d057186bc6209d991
+  data.tar.gz: 5b5eff2de32dfe89a2110558bce22e1a11ddf4cc6ed9d69e903b6c087575e5a9e48e20fbea39a95eade2d69e67b6d49db7ae68874e947aa93ae4a8896852cbf6

data/lib/remotedroid.rb

@@ -13,6 +13,10 @@ require 'ruby-macrodroid'
 # 
 # # Triggers
 #
+# ## Device Events
+#
+# * screen on
+#
 # ## Sensors
 # 
 # * proximity (near)
@@ -22,6 +26,14 @@ require 'ruby-macrodroid'
 #
 # # Actions
 #
+# ## Camera/Photo
+#
+# * Take Picture
+#
+# ## Connectivity
+#
+# * Enable HotSpot
+#
 # ## Date/Time
 #
 # * Say Current Time
@@ -30,16 +42,70 @@ require 'ruby-macrodroid'
 #
 # * Speak text
 # * Torch toggle
+# * vibrate
 #
 # ## Location
 #
 # * Share Location
 #
+# ## Media
+#
+# * Play sound (Doda)
+#
 # ## Notification
 #
 # * Popup Message
 #
+# ## Screen
+#
+# * Screen On
+#
 
+# Variables which can be queried
+#
+# Description                         Variable
+# -------------------                 ----------------
+# Foreground app name                 :fg_app_name
+# Foreground app package              :fg_app_package
+# Current Brightness                  :current_brightness
+# Screen timeout (seconds)            :screen_timeout
+# Current battery %                   :battery
+# Battery temp °C                     :battery_temp
+# Power (On/Off)                      :power
+# Clipboard text                      :clipboard
+# Current IP address                  :ip
+# Wifi SSID                           :ssid
+# Wifi signal strength                :wifi_strength
+# System time                         :system_time
+# IMEI                                :imei
+# Cell Id                             :cell_id
+# Last known location (lat,lon)       :last_loc_latlong
+# Last known location (altitude)      :last_loc_alt
+# Last known location (link)          :last_loc_link
+# Last known location (time)          :last_loc_age_timestamp
+# Last known location (kmh)           :last_loc_speed_kmh
+# Last known location (mph)           :last_loc_speed_mph
+# Current Volume (Alarm)              :vol_alarm
+# Current Volume (Media / Music)      :vol_music
+# Current Volume (Ringer)             :vol_ring
+# Current Volume (Notification)       :vol_notif
+# Current Volume (System Sounds)      :vol_system
+# Current Volume (Voice Call)         :vol_call
+# Current Volume (Bluetooth Voice)    :vol_bt_voice
+# Device name                         :device_name
+# Device uptime                       :uptime_secs
+# Device manufacturer                 :device_manufacturer
+# Device model                        :device_model
+# Android version                     :android_version
+# Android version (SDK Level)         :android_version_sdk
+# Storage total (external)            :storage_external_total
+# Storage free (external)             :storage_external_free
+# Storage total (internal)            :storage_internal_total
+# Storage free (internal)             :storage_internal_free
+
+
+# The macros below are exported to JSON format as a file which is imported into
+# the Android device running MacroDroid.
 
 RD_MACROS =<<EOF
 m: Camera flash light
@@ -66,6 +132,40 @@ v: text
 t: webhook
 a: speak text ([lv=text])
 
+m: vibrate
+t: webhook
+a: vibrate
+
+m: play doda
+t: webhook
+a: play: Doda
+
+m: Screen
+v: on: false
+t: WebHook
+a:
+  If on = True
+    Screen On
+  Else
+    Screen Off
+  End If
+
+m: Hotspot
+v: enable: false
+t: WebHook
+a:
+  If enable = True
+    Enable Hotspot
+  Else
+    Disable Hotspot
+  End If
+
+m: Take Picture
+t: webhook
+a:
+  Take Picture
+    Rear Facing
+
 m: Share location
 t: 
   WebHook
@@ -78,7 +178,49 @@ a:
   HTTP GET
     identifier: location
     coords: [lv=coords]
+    type: query
 
+m: query
+t: WebHook
+v: qvar
+a:
+  Set Variable
+    var: [[lv=qvar]]
+a:    
+  HTTP GET
+    [lv=qvar]: [lv=var]
+
+m: query setting system
+t: WebHook
+v: qvar
+a:
+  Set Variable
+    var: [setting_system=[lv=qvar]]
+a:    
+  HTTP GET
+    [lv=qvar]: [lv=var]    
+    
+m: query setting global
+t: WebHook
+v: qvar
+a:
+  Set Variable
+    var: [setting_global=[lv=qvar]]
+a:    
+  HTTP GET
+    [lv=qvar]: [lv=var]    
+    
+m: query setting secure
+t: WebHook
+v: qvar
+a:
+  Set Variable
+    var: [setting_secure=[lv=qvar]]
+a:    
+  HTTP GET
+    [lv=qvar]: [lv=var]    
+    
+        
 m: shake device
 t: shake device
 a: webhook
@@ -89,9 +231,30 @@ a:
   webhook
     identifier: proximity
     option: 0
+    
+m: Power connected
+t: Power Connected: Any
+a: webhook
+
+m: screen on off
+t: screen on
+a: webhook
 
 EOF
 
+=begin
+m: Screen
+v: on: true
+t: WebHook
+a:
+  If on = true
+    Screen On
+  Else
+    Screen Off
+  End If
+
+=end
+
 module RemoteDroid
 
   class Model
@@ -322,7 +485,7 @@ module RemoteDroid
   class Controller
     
     attr_reader :model, :control
-    attr_accessor :title, :macros
+    attr_accessor :title, :macros, :store
 
     def initialize(mcs, model=MODEL, deviceid: nil, debug: false)
       
@@ -335,6 +498,9 @@ module RemoteDroid
       if model then
         @model = Model.new(model)
       end
+      
+      @store = {}
+      @query = Query.new(self)
 
     end
     
@@ -343,7 +509,12 @@ module RemoteDroid
     end
     
     def invoke(name, options={})      
-      @control.method(name.to_sym).call(options)
+      
+      if @control.respond_to? name.to_sym then
+        @control.method(name.to_sym).call(options)
+      else
+        @control.http_exec name.to_sym, options
+      end
     end
 
     # Object Property (op)
@@ -354,12 +525,33 @@ module RemoteDroid
       @model.op
     end
     
-    def query(trigger)
+    def query(id=nil)
+      
+      return @query unless id
+      
+      @store[id] = nil
+
+      sys = %i(accelerometer_rotation)      
       
-      @h[trigger] = nil
+      global = [:airplane_mode_on, :bluetooth_on, :cell_on, :device_name, \
+                :usb_mass_storage_enabled, :wifi_on]       
+      
+      secure = %i(bluetooth_name flashlight_enabled)
+
       
       # send http request via macrodroid.com API
-      @control.http_exec trigger
+      
+      if id.downcase.to_sym == :location then
+        @control.http_exec id
+      elsif sys.include? id
+        @control.http_exec :'query-setting-system', {qvar: id}        
+      elsif global.include? id
+        @control.http_exec :'query-setting-global', {qvar: id}
+      elsif secure.include? id
+        @control.http_exec :'query-setting-secure', {qvar: id}        
+      else
+        @control.http_exec :query, {qvar: id}
+      end
       
       # wait for the local variable to be updated
       # timeout after 5 seoncds
@@ -367,11 +559,12 @@ module RemoteDroid
       
       begin
         sleep 1
-      end until @h[trigger] or Time.now > t + 5
+      end until @store[id] or Time.now > t + 5
       
-      if @h[trigger] then
-        yield(@h[trigger])
-      end
+      return {warning: 'HTTP response timeout'} if Time.now > t+5
+      
+      return @store[id]
+
       
     end    
     
@@ -408,10 +601,12 @@ module RemoteDroid
     end
     
     alias trigger_fired trigger
+    
+    def update(id, val)
+      key  = id == :location ? id : val.keys.first.to_sym
+      @store[key] = val      
+    end
         
-    def store()
-      @h
-    end    
 
   end
 
@@ -441,6 +636,13 @@ module RemoteDroid
     end
     
   end
+  
+  class ControlHelper
+    
+    def initialize(callback)
+      @callback
+    end
+  end
 
   class Control        
     
@@ -448,7 +650,7 @@ module RemoteDroid
       
       @deviceid, @remote_url, @debug = deviceid, remote_url, debug
       @torch = Torch.new(self)
-    end
+    end    
     
     def bluetooth()
       @bluetooth
@@ -457,6 +659,33 @@ module RemoteDroid
     def camera_flash_light(options={})
       http_exec 'camera-flash-light', options
     end
+    
+    def hotspot(state=nil)      
+      
+      if state then
+        http_exec 'hotspot', {enable: state == :enable} 
+      else        
+
+        def self.enable()
+          http_exec 'hotspot', {enable: true}
+        end                
+        
+        def self.on()
+          self.enable
+        end                
+        
+        def self.disable()
+          http_exec 'hotspot', {enable: false} 
+        end
+        
+        def self.off()
+          self.disable
+        end         
+        
+        self
+        
+      end
+    end    
         
     def http_exec(command, options={})
       
@@ -482,14 +711,50 @@ module RemoteDroid
     
     alias say_time say_current_time
     
+    def screen(state=nil)      
+      
+      if state then
+        http_exec 'screen', {on: state == :on} 
+      else        
+        
+        def self.on()
+          http_exec 'screen', {on: true}
+        end
+        
+        def self.off()
+          http_exec 'screen', {on: false} 
+        end
+        
+        self
+        
+      end
+    end
+    
     def share_location(options={})
       http_exec 'share-location'
     end
     
-    def speak_text(options={})
+    def speak_text(obj)
+      
+      options = case obj
+      when String
+        {text: obj}
+      when Hash
+        obj
+      end
+    
       http_exec 'speak-text', options
     end
     
+    alias say speak_text
+
+    def take_picture(options={})
+      http_exec :'take-picture', options
+    end
+    
+    alias take_photo take_picture
+
+    
     def toast(options={})
       http_exec :toast, options
     end
@@ -497,6 +762,10 @@ module RemoteDroid
     def torch(options={})
       http_exec :torch 
     end
+    
+    def vibrate(options={})
+      http_exec :vibrate
+    end    
 
 
     def write(s)
@@ -508,12 +777,55 @@ module RemoteDroid
     
     alias export write
     
-    def method_missing(method_name, *args)
+    def method_missing2(method_name, *args)
       http_exec(method_name, args.first)
     end    
     
   end
   
+  class Query
+    
+    def initialize(callback)
+      @callback = callback
+    end
+    
+    def airplane_mode_enabled?()
+      q(:airplane_mode_on).to_i > 0 
+    end
+    
+    def battery()      
+      q(:battery).to_i
+    end
+    
+    def current_brightness()      
+      q(:current_brightness).to_i
+    end
+
+    alias brightness current_brightness
+    
+    def cell_id()      
+      q(:cell_id)
+    end
+    
+    alias cell_tower cell_id
+    
+    def ip()      
+      q(:ip)
+    end    
+    
+    def location()      
+      @callback.query(:location)[:coords]
+    end
+
+    
+    private
+    
+    def q(id)
+      @callback.query(id)[id]
+    end
+    
+  end
+  
   class Server
     
     def initialize(s, drb_host: '127.0.0.1', deviceid: nil)
@@ -536,6 +848,10 @@ module RemoteDroid
       @drb = OneDrb::Client.new host: host, port: '5777'    
     end
     
+    def control
+      @drb.control
+    end
+    
     def export(s)
       @drb.export(s)
     end
@@ -543,13 +859,107 @@ module RemoteDroid
     def invoke(s, *args)
       @drb.invoke(s, *args)
     end
+    
+    def query(id=nil)
+      
+      return @drb.query unless id
+      t = Time.now
+      h = @drb.query(id)
+      h.merge({latency: (Time.now - t).round(3)})
+      
+    end
+    
+    def update(key, val)
+      @drb.update key.to_sym, val
+    end
+    
+    def store()
+      @drb.store
+    end
+    
+    # -- helpful methods -----------------
+    
+    def battery()
+      query.battery
+    end
+    
+    def cell_tower()
+      query.cell_tower
+    end
+    
+    def hotspot(state=nil)      
+      control.hotspot state
+    end    
+    
+    def location()
+      query.location
+    end
+    
+    def photo()
+      take_picture
+    end
+    
+    def say(text)
+      control.speak_text text
+    end
+    
+    def say_time()
+      control.say_time
+    end
+    
+    alias saytime say_time
+    
+    def screen(state=nil)      
+      control.screen state
+    end
+    
+    def screen_on()
+      screen :on
+    end
+    
+    def screen_off()
+      screen :off
+    end
+    
+    def take_picture(ftp_src: nil, fileout: '.')
+      
+      screen.on
+      r = control.take_picture
+            
+      if ftp_src then
+        
+        # the sleep statement will be replaced in the near future, 
+        # but it's fine to demonstrate it works
+        sleep 8         
+        
+        credentials, dir = ftp_src.match(/(ftp:\/\/[^\/]+)\/([^$]+)/).captures
+        ftp = MyMediaFTP.new(credentials)
+        ftp.cd dir
+        filename = ftp.ls.sort_by {|x| x[:ctime]}.last[:name]
+        ftp.cp filename, fileout
+        
+      end
+      
+    end   
+    
+    def take_photo()
+      control.take_photo
+    end
+    
+    def torch()
+      control.torch
+    end    
+    
+    def vibrate
+      control.vibrate
+    end
       
   end
   
   class TriggerSubscriber < SPSSub
     
     def initialize(host: 'sps.home', drb_host: '127.0.0.1')
-      @remote = OneDrb::Client.new host: drb_host, port: '5777'      
+      @remote = OneDrb::Client.new host: drb_host, port: '5777'    
       super(host: host)
     end
     
@@ -570,7 +980,7 @@ module RemoteDroid
   class ActionSubscriber < SPSSub
     
     def initialize(host: 'sps.home', drb_host: '127.0.0.1')
-      @remote = OneDrb::Client.new host: drb_host, port: '5777'      
+      @remote = OneDrb::Client.new host: drb_host, port: '5777'    
       super(host: host)
     end    
     
@@ -589,5 +999,25 @@ module RemoteDroid
     
   end
   
-  
+  class ResponseSubscriber < SPSSub
+    
+    def initialize(host: 'sps.home', drb_host: '127.0.0.1')
+      @remote = OneDrb::Client.new host: drb_host, port: '5777'    
+      super(host: host)
+    end    
+    
+    def subscribe(topic: 'macrodroid/response')
+      
+      super(topic: topic) do |msg|
+        
+        json, id = msg.split(/:\s+/,2).reverse
+        h = JSON.parse(json, symbolize_names: true)
+        id ||= h.keys.first
+        @remote.update id.to_sym, h
+        
+      end
+      
+    end
+    
+  end  
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: remotedroid
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.3
 platform: ruby
 authors:
 - James Robertson
@@ -35,7 +35,7 @@ cert_chain:
   io3WPRDjULC924M5S8wbrus31v2AUjqFBPvmHr7caf/VHErWypV482xcDhWt1eif
   0G2k2ptozXcBS9odsqGUTb5N
   -----END CERTIFICATE-----
-date: 2020-10-06 00:00:00.000000000 Z
+date: 2020-10-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: onedrb
@@ -106,7 +106,7 @@ dependencies:
         version: '0.9'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.9.2
+        version: 0.9.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -116,7 +116,7 @@ dependencies:
         version: '0.9'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.9.2
+        version: 0.9.7
 description: 
 email: james@jamesrobertson.eu
 executables: []