remotedroid 0.1.1 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8182bbf99c5d4129da2c118d695a98ddbe0f11f95912ddd1d5efbf4dd78e1729
-  data.tar.gz: 773d8738eb35ff52275fc425326a0ebd6cdd43dd209de7090040e1347bfcc463
+  metadata.gz: 6bd8aa94326f04e26626c2919060c259afea85c5e89f6ae33de505d0af5381b6
+  data.tar.gz: efbb77b568cc56a821569021dfd6a1c4001645a0019d0d3d56445a3f31887737
 SHA512:
-  metadata.gz: 52271972500cd3a2f18da5494247d64e660687188a525f98b929f87c462aaf2296e1d78630c413a13088548261e01034d87df2192d67f461c2b4899284d95c04
-  data.tar.gz: 6f57080d7164e68ee66db0ef4e864bfdad9a149adef0f7753bbe74d0ccf85929e82d918b458df0423c58a369721c26074be7b0f181e891d0d192737cbb5f1d03
+  metadata.gz: 68ca84c69885979de74d5265b216808dba934f63854978ffde5e48a49458f88e3483294f555f36685b1a5cc44b2309b285870228c5eb63ca3759b0e41eb7b752
+  data.tar.gz: ba2aa7d3d3fbf3512b3cfdbd55aa7442499355c3110bcfed6b92a5da516f4a4e39eb3ff8eff6fba5f3702aeb739562d2bde777c31e2c0ce6a9a9581287fda93f

data/lib/remotedroid.rb

@@ -22,6 +22,10 @@ require 'ruby-macrodroid'
 #
 # # Actions
 #
+## Connectivity
+#
+# * Enable HotSpot
+#
 # ## Date/Time
 #
 # * Say Current Time
@@ -30,11 +34,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
@@ -61,6 +124,90 @@ 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: Share location
+t: 
+  WebHook
+    identifier: location
+a: Force Location Update    
+a:
+  Share Location
+    coords
+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
@@ -71,9 +218,27 @@ a:
   webhook
     identifier: proximity
     option: 0
+    
+m: Power connected
+t: Power Connected: Any
+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
@@ -304,7 +469,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)
       
@@ -317,6 +482,9 @@ module RemoteDroid
       if model then
         @model = Model.new(model)
       end
+      
+      @store = {}
+      @query = Query.new(self)
 
     end
     
@@ -325,7 +493,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)
@@ -336,6 +509,49 @@ module RemoteDroid
       @model.op
     end
     
+    def query(id=nil)
+      
+      return @query unless id
+      
+      @store[id] = nil
+
+      sys = %i(accelerometer_rotation)      
+      
+      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
+      
+      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
+      t = Time.now
+      
+      begin
+        sleep 1
+      end until @store[id] or Time.now > t + 5
+      
+      return {warning: 'HTTP response timeout'} if Time.now > t+5
+      
+      return @store[id]
+
+      
+    end    
+    
     def request(s)
       @model.request s
     end
@@ -369,6 +585,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
+        
 
   end
 
@@ -398,6 +620,13 @@ module RemoteDroid
     end
     
   end
+  
+  class ControlHelper
+    
+    def initialize(callback)
+      @callback
+    end
+  end
 
   class Control        
     
@@ -405,7 +634,7 @@ module RemoteDroid
       
       @deviceid, @remote_url, @debug = deviceid, remote_url, debug
       @torch = Torch.new(self)
-    end
+    end    
     
     def bluetooth()
       @bluetooth
@@ -414,6 +643,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={})
       
@@ -429,16 +685,53 @@ module RemoteDroid
       
     end
     
+    def location(options={})
+      http_exec 'location'
+    end    
+    
     def say_current_time(options={})
       http_exec 'say-current-time'
     end    
     
     alias say_time say_current_time
     
-    def speak_text(options={})
+    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(obj)
+      
+      options = case obj
+      when String
+        {text: obj}
+      when Hash
+        obj
+      end
+    
       http_exec 'speak-text', options
     end
     
+    alias say speak_text
+    
     def toast(options={})
       http_exec :toast, options
     end
@@ -446,6 +739,11 @@ module RemoteDroid
     def torch(options={})
       http_exec :torch 
     end
+    
+    def vibrate(options={})
+      http_exec :vibrate
+    end    
+
 
     def write(s)
             
@@ -456,12 +754,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)
@@ -478,10 +819,95 @@ module RemoteDroid
 
   end
   
+  class Client
+    
+    def initialize(host='127.0.0.1')
+      @drb = OneDrb::Client.new host: host, port: '5777'    
+    end
+    
+    def control
+      @drb.control
+    end
+    
+    def export(s)
+      @drb.export(s)
+    end
+    
+    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 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 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
     
@@ -502,7 +928,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    
     
@@ -521,5 +947,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.1.1
+  version: 0.4.2
 platform: ruby
 authors:
 - James Robertson
@@ -35,7 +35,7 @@ cert_chain:
   io3WPRDjULC924M5S8wbrus31v2AUjqFBPvmHr7caf/VHErWypV482xcDhWt1eif
   0G2k2ptozXcBS9odsqGUTb5N
   -----END CERTIFICATE-----
-date: 2020-10-03 00:00:00.000000000 Z
+date: 2020-10-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: onedrb
@@ -103,20 +103,20 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '0.9'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.8.12
+        version: 0.9.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '0.9'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.8.12
+        version: 0.9.7
 description: 
 email: james@jamesrobertson.eu
 executables: []