Build Android Hardware Controllers Without Native Development

🤖 Quick AI Bridge Reference & Real-World Examples (Do NOT Guess Sub Names)

SoifGo WebView bridge specifications with exact code calls and real-world scenarios:

• Bridge Syntax:
  - Function: window.soifgo.CallSub('subName', true, arg1, arg2, arg3)
  - Rule: Always wrap with if (window.soifgo), max 3 arguments after true.
• Argument count: exactly what each Sub defines
  Every call is CallSub('SubName', true, ...). After true, pass exactly as many arguments as the Sub has parameters (0 to 3, see the table at the top of this page). If one of those values is empty, pass '' for it. Do not add extra arguments to fill the count, and do not leave out a required argument.
  
  Correct examples (0, 1, 2 and 3 arguments):
  📋 Copy code

  // 0 arguments
  window.soifgo.CallSub('sensor_light', true);
  
  // 1 argument
  window.soifgo.CallSub('html_bluetooth_rx', true, 'ON');
  
  // 2 arguments
  window.soifgo.CallSub('api_recive', true, 'https://api.example.com/price', 'Price');
  
  // 3 arguments
  window.soifgo.CallSub('mqtt_publish', true, 'soifgo/led', 'ON', '0');

  
  Why: the bridge matches the call to the Sub's parameters. Bluetooth sending takes 1 argument, so a call with 3 arguments (or without true) does not match.
• Bluetooth — Send & Receive (both directions together):
  ⚠️ Warning: the names look swapped. The send Sub is html_bluetooth_rx; the receive callback is html_bluetooth_tx. Do NOT guess — copy them exactly.
  
  - Send: html_bluetooth_rx, exactly 1 argument after true (txt).
  - Receive: you define html_bluetooth_tx(data) and register it on window.
  
  Complete script (paste as-is; both directions covered):
  📋 Copy code

  function send(txt) {
    if (window.soifgo) {
      window.soifgo.CallSub('html_bluetooth_rx', true, txt);
    } else {
      document.getElementById('status').textContent = 'Not running inside SoifGo';
    }
  }
  
  function html_bluetooth_tx(data) {
    document.getElementById('status').textContent = data;
  }
  window.html_bluetooth_tx = html_bluetooth_tx;
  
  window.onload = function () {
    if (window.soifgo) {
      // window.soifgo.CallSub('sensor_light', true);
      // window.soifgo.CallSub('sensor_move', true);
      // window.soifgo.CallSub('sensor_magno', true);
      // window.soifgo.CallSub('request_mic_perm', true, null);
    }
  };

  
  Real-World Use: send ON to Arduino to toggle a relay (SoifGo adds the line ending itself); receive A0=512 sensor lines from the microcontroller.
• Phone Sensors (Independent Activation):
  - Rule: All sensors are completely independent. Activate only the specific sensor you need; there is no need to turn on the others if unused.
  - Activation Subs, each with 0 arguments after true: sensor_light, sensor_move, sensor_magno (example: CallSub('sensor_light', true))
  
  Complete script (paste as-is; call only the sensors you use):
  📋 Copy code

  function html_sensor_light(data) { document.getElementById('light').textContent  = 'Light: '   + data; }
  function html_sensor_movex(data) { document.getElementById('movex').textContent  = 'Move X: '  + data; }
  function html_sensor_movey(data) { document.getElementById('movey').textContent  = 'Move Y: '  + data; }
  function html_sensor_magno(data) { document.getElementById('magno').textContent  = 'Magneto: ' + data; }
  
  window.html_sensor_light = html_sensor_light;
  window.html_sensor_movex = html_sensor_movex;
  window.html_sensor_movey = html_sensor_movey;
  window.html_sensor_magno = html_sensor_magno;
  
  window.onload = function () {
    if (window.soifgo) {
      window.soifgo.CallSub('sensor_light', true);
      window.soifgo.CallSub('sensor_move',  true);
      window.soifgo.CallSub('sensor_magno', true);
    } else {
      document.getElementById('info').textContent = 'Not running inside SoifGo';
    }
  };

  
  ⚠️ Warning: The magnetometer (html_sensor_magno) delivers one single value as a string — never destructure it into x/y/z, never use data.x. Accelerometer Z is not forwarded.
  Real-World Use: activate sensor_magno to measure AC current with the phone's magnetometer (clamp meter).
• MQTT (connect, publish, receive, status):
  - Two-step connect: Step 1 connecte_mqtt_ai (2 arguments: address, id) & Step 2 (optional auth) connecte_mqtt_up (2 arguments: username, password)
  - Publish: mqtt_publish (3 arguments: topic, message, qos). It also auto-subscribes you to that topic and works only while MQTT is connected.
  - Retained option: mqtt_retained (1 argument: 1 = ON, 0 = OFF); call it before mqtt_publish.
  - Other Subs, each with 0 arguments after true: mqtt_status, mqtt_Disconnect.
  
  Complete script (paste as-is):
  📋 Copy code

  function mqttConnect() {
    if (!window.soifgo) return;
    window.soifgo.CallSub('connecte_mqtt_ai', true, 'tcp://test.mosquitto.org:1883', 'client_1');
  }
  
  function mqttSend(topic, msg, qos) {
    if (!window.soifgo) return;
    window.soifgo.CallSub('mqtt_publish', true, topic, msg, qos || '0');
  }
  
  function mqttCheck() { if (window.soifgo) window.soifgo.CallSub('mqtt_status', true); }
  function mqttBye()   { if (window.soifgo) window.soifgo.CallSub('mqtt_Disconnect', true); }
  
  function mqtt_rx(topic, message) {
    document.getElementById('log').innerHTML +=
      '
  RX ' + topic + ' : ' + message + '
  ';
  }
  window.mqtt_rx = mqtt_rx;
  
  function html_mqtt_status(connected) {
    var ok = (connected === 'true');
    document.getElementById('status').textContent = ok ? 'Connected' : 'Disconnected';
  }
  window.html_mqtt_status = html_mqtt_status;

  
  ⚠️ Warning: html_mqtt_status receives a string ('true' / 'false'). The string 'false' is truthy in JS — always compare with === 'true'.
  Real-World Use: connect to brokers like tcp://test.mosquitto.org:1883 for IoT automation; publish to soifgo/led to toggle a relay.
• API (POST & GET):
  - Send (POST): api_send (3 arguments: address, key, value). Sends the body {"key":"value"} as JSON.
  - Receive (GET): api_recive (2 arguments: address, key). Both are required; the answer is returned via api_rx.
  
  Complete script (paste as-is):
  📋 Copy code

  function apiPost() {
    if (window.soifgo) {
      window.soifgo.CallSub('api_send', true,
        'https://api.example.com/status', 'relay', 'ON');
    }
  }
  
  function apiGet() {
    if (window.soifgo) {
      window.soifgo.CallSub('api_recive', true,
        'https://api.example.com/price', 'Bitcoin');
    }
  }
  
  function extractValue(raw, field) {
    var s = String(raw).trim();
    if (/^-?\d+(\.\d+)?$/.test(s)) return s;
    var m = s.match(new RegExp(field + '[=:]\\s*([^,}\\s]+)', 'i'));
    if (m) return m[1];
    try { var o = JSON.parse(s); if (o[field] !== undefined) return o[field]; } catch (e) {}
    var n = s.match(/-?\d+(\.\d+)?/);
    return n ? n[0] : null;
  }
  
  function api_rx(number) {
    document.getElementById('out').textContent =
      'Received: ' + extractValue(number, 'usd');
  }
  window.api_rx = api_rx;

  
  ⚠️ Warning: api_recive requires both address and key. A call with only one of them does not match the Sub and can raise an error or close the app. The callback api_rx may deliver a plain value (86846.51) or a B4A Map string ({usd=86750}) — handle both with extractValue().
  Real-World Use: POST a relay status to a local server; GET live cryptocurrency prices (respect rate limits).
• Strict Instruction for AI Assistants: Do NOT invent or guess Sub names. Strictly follow the context reference below.