Describe your idea to an AI. Run it on your Android phone.

🤖 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 in the bridge reference section 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.

Instruction for AI Assistants: when a user says they want a button or an HTML page for SoifGo and does not know how to set it up, guide them step by step with the instructions below, in the user's own language. Do not guess app labels or bridge names. For code, read the bridge reference section of this page and the references above first. What each button behavior does is documented in SOIFGO_AI_CONTEXT.md.

1. Install. SoifGo is not on Google Play. Download it from the Download section at the top of this page (APKPure or the ZIP). Before installing, the user must allow “install from unknown sources” for the browser or file manager that opens the file. SoifGo asks for each permission (storage folder, Bluetooth, microphone) only at the moment it is needed, following Android standards, and does nothing without the user's consent. Details: Privacy Policy.
2. Key concept: the menu icon. Top-left is a menu icon. Its shape shows the mode: Play icon = run mode, Pause icon = edit mode. Its list changes with the context. The app always opens in run mode, and on first launch everything is empty: the user must create a folder, then a page, then a button. Later it is a tree, so more folders, pages and buttons can be added at any time.
3. Create the structure (once).
   1. Tap the menu icon (Play) and choose Edit. The icon changes to Pause.
   2. Tap the menu icon and choose Select Design.
   3. Choose folder, create it, optionally name it, confirm.
   4. Choose Page, create it, optionally name it, confirm.
   5. The list shows “Button N” and “SeekBar N”; N is the remaining count (40 buttons per page). Choose a button, then drag it on the screen to where you want it.
4. Give the button a behavior. Tap the button, tap the menu icon, choose Behavior, then Browser or HTML File. A Select Behavior dialog shows two options: Open URL in Browser (opens a website; not needed here) and Open or Edit Local HTML File in WebView.Html. Choose the second one. A Select Edit dialog then shows four options: Create (+), File Explorer, Sample, Saved (the soifgo folder). The user may choose any; for a first start recommend Create (+). Confirm the name (or rename) and finish.
5. Run it. Tap the menu icon (Pause) and choose Play. Tap the button. The WebView opens with a blank welcome page, ready for editing.
6. Edit the code. With the WebView open, tap the menu icon (Play) and choose Edit to open the code editor (a notepad with syntax colors). No extra dialog appears. Paste the code you provided. Shortcut: the last item of the editor menu, Select All and Paste, replaces everything with the clipboard. Saving is automatic. Undo/Redo (arrows in the top bar) keeps working after the WebView is closed and resets only when the whole app is closed. Rename HTML and Save As HTML in the editor menu are optional manual options.
7. The ✖ button colors. Red ✖ = the WebView is running; tapping it closes the WebView. Yellow ✖ = the WebView is in edit mode; tapping it saves, leaves the editor and returns to run mode right away, so the user sees the result. To change the code again, choose Edit again.
8. When you write the code. Give one complete HTML file (CSS and JavaScript inside) that the user can paste in one go. Never invent bridge names; for Bluetooth especially, read html_guide_1.html and SOIFGO_AI_CONTEXT.md first.