App tal-K-Aġent Kramer

Introduzzjoni

Merħba f'K-Agent, is-softwer tal-ġestjoni tat-touch panel tal-ġenerazzjoni li jmiss ta' Kramer għal Kramer Control & Session Manger li jipprovdi kapaċitajiet imtejba ta' amministrazzjoni remota għat-Touch Panels tas-Serje KT-20x.

X'inhu K-Aġent?
K-Agent is a powerful software application that enables:

• Remote tablet management and monitoring
• Awtomatizzat URL launching in full-screen mode
• Display policy management and power control
• Secure device locking and access control
• API-based remote administration

Karatteristiċi Ewlenin
Enhanced Administration

• Ping and health monitoring
• Remote URL tnedija
• Device reboot capabilities
• Secure PIN-based access control

Advanced Display Management

• Configurable brightness and dimming controls
• Automatic display timeout settings
• Immersive full-screen mode support

Konnettività Flessibbli

• HTTP and HTTPS API support
• Integration with Kramer Control Brain systems
• Support for multiple interface configurations

Device-Specific Features (KT-20x Touch Panels)

• LED sidebar control and color customization
• Enhanced brightness management
• Settings tal-wiri avvanzati

Nibdew

Rekwiżiti tas-Sistema

Konfigurazzjoni tan-Netwerk

• K-Agent must be reachable on ports 9803 (HTTP) or 9804 (HTTPS)
• K-Agent must be able to reach Brain systems on ports 8000-8049 or 9000-9049 (HTTPS)
• Supported Brain systems: KC-VirtualBrain-1, 5, 25, or 50

Ħardwer Kompatibbli

• KT-20x Series Touch Panels with K-Agent software installed
• Network connectivity (Ethernet or Wi-Fi)

Installazzjoni Overview

• K-Agent jiġi installat minn qabel fuq Touch Panels tas-Serje KT-20x kompatibbli. Għall-proċeduri ta' installazzjoni tal-ħardwer u setup tan-netwerk, irreferi għall-manwal speċifiku tal-ħardwer tat-touch panel tiegħek.
• K-Agent irid jitnieda manwalment waqt l-ewwel attivazzjoni biex tiġi attivata l-funzjonalità tal-istartjar awtomatiku.

K-Agent Overview

Interface tal-Applikazzjoni
Meta taċċessa l-K-Agent għall-ewwel darba, se tara l-interfaċċja ewlenija tas-Settings bi tliet żoni ta' konfigurazzjoni primarji:

Struttura tal-Panel tas-Settings

• Left Panel: Configuration Options
• Full Screen Mode toggle
• Display Policy toggle
• Lock Tablet toggle
• Version information (bottom left)
• Right Panel: Configuration Details
• Context-sensitive settings based on selected option
• URL oqsma ta' konfigurazzjoni
• Policy and security settings

Navigazzjoni u Aċċess

Accessing K-Agent Settings

1. Swipe up from the center bottom of the screen
   The IPad app requires a 2 finger right to left gesture and does not support a pincode
2. Enter PIN code (default: 9428)
3. Access settings panels and configuration options

Ħruġ mis-Settings
Press Apply to save changes and return to full-screen mode
Settings are automatically saved

Setup u Konfigurazzjoni Inizjali

L-Ewwel Ħin Issettjat
Wara li tinstalla t-touch panel tiegħek, segwi dawn il-passi għall-konfigurazzjoni inizjali:

1. Step 1: Launch K-Agent
   1. Locate the K-Agent icon on your touch panel home screen
   2. Tap to launch the application
   3. The settings interface will appear for first-time configuration
2. Step 2: Configure Network Access
   Ensure your touch panel can communicate with your Brain system:
   • Verify network connectivity
   • Confirm firewall settings allow required ports
   • Test connectivity to your Brain system IP address
3. Pass 3: Issettja URL Konfigurazzjoni

Agħżel wieħed minn tliet metodi biex tikkonfigura l-interfaċċja tiegħek URL:

1. Method 1: Browse and Select (Recommended)
   1. In Full Screen Mode settings, tap “Browse and select a URL"
   2. Enter your Brain IP address and port
   3.  Select from available interfaces
   4. Applika konfigurazzjoni
2. Method 2: API Configuration (Recommended for System Integrators)
   • Use API calls to remotely configure URLs
   • See API Reference section for details
3. Method 3: Manual Entry (Not Recommended)
   • Manually type the complete URL in the configuration field
   • Ensure exact syntax and formatting

Konfigurazzjoni tal-Interface tal-Utent

Modalità Sħiħ Screen
Full Screen Mode is the primary operational mode for K-Agent, providing immersive interface display

Għażliet ta' Konfigurazzjoni

Tablet Skrin Sħiħ URL

• Interfaċċja primarja URL for continuous display
• Supports Kramer Control Brain interfaces & Session Manager Tablet Templates
• Immersive mode available (adds “&immersive=true” parameter)
• URL Format Eż.ample: http://192.168.88.149:8000/?interface=43c286c8-ee1e-452f-b123-23afee72af1b&page=606cd9e0-9499-4d1f-8cf8-12441bee8c56

Secondary Control Address

• Optional secondary Brain IP address
• Used for backup control systems in the event of a brain Failure

Prerekwiżiti
Before configuring a secondary control address, you must:

• Create a Reference Space
  • Access your Project in the manager
  • Navigate to Space Management
  • Create a new reference space based on your existing master space
  • Ensure all interface configurations are replicated
• Provision to Secondary Brain
  • Deploy the reference space to your backup Brain system
  • Verify the secondary Brain system is network accessible
  • Confirm the same interface and page IDs are maintained across both spaces
• Rekwiżiti tan-Netwerk
  • Both Brain systems must be accessible from the touch panel
  • Standard port requirements apply (8000-8049 or 9000-9049)
  • Network routing must support failover scenarios
• Failover Behavior
  • K-Agent automatically detects primary Brain unavailability
  • Transition to secondary Brain system
  • Interface state and functionality preserved during switchover if device states are used for UI Changes
  • Manual return to primary interface is required when available
• Konfigurazzjoni Eżamples
  • Primary Configuration (Tablet Full-Screen URL)  http://192.168.88.253:8000/?interface=43c286c8-ee1e-452f-b123-23afee72af1b&page=606cd9e0-9499-4d1f-8cf8-12441bee8c56
  • Secondary Configuration (Secondary Control Address) 192.168.88.254:8000
  • Result During Failover
  • The system automatically constructs the failover URL: http://192.168.88.254:8000/?interface=43c286c8-ee1e-452f-b123-23afee72af1b&page=606cd9e0-9499-4d1f-8cf8-12441bee8c56

Popup tat-Tablet URL

• Sekondarja URL for overlay interfaces
• Can be triggered by API calls or interface buttons
• Supports immersive mode
• Renders the “popup” page using 80% of the touch panel canvas
• Please see the API Details Section

Modalità Immersiva
Immersive mode provides a true full-screen experience by removing the interface selection frame:

• Automatically appends “&immersive=true” to URLs
• Hides browser navigation elements
• Recommended for production deployments
• Users can only exit via PIN entry

Browse and Select URL Karatteristika
Il-karatteristika Browse and Select tissimplifika URL konfigurazzjoni:

Using Browse and Select

1. Access the Feature
   • In Full Screen Mode settings
   • Click “Browse and select a URL"
2. Connect to Brain
   • Enter Brain IP address and port in the embedded browser
   • Example: 192.168.88.253:8000
     
3. Agħżel Interface
   • Browse available interfaces
   • Click desired interface
   • Click Apply to confirm selection
4. Konfigurazzjoni Awtomatika
   • URL automatically populates in settings field
   • Interface loads in full-screen mode

Settings Avvanzati

Display Policy
Il-Politika tal-Wiri tipprovdi ġestjoni komprensiva tal-enerġija u kontroll tal-wiri.

Għażliet ta' Konfigurazzjoni
Set Default Brightness Level

• Perċenswalitage of maximum brightness (0-100%)
• Applied when display reactivates
• Slider control for easy adjustment

Display Timeout (Timer)

• Dimming: Minutes of inactivity before dimming to 20% brightness
• Display Off: Minutes of inactivity before turning off display
• Display Off must be longer than Dimming timeout

KT-20x Enhanced Features
For KT-20x Touch Panels, additional display controls are available via API:

• LED sidebar color control
• Advanced brightness management
• Extended display policies

Lock Pillola
Lock Tablet provides security and access control features

Konfigurazzjoni tas-Sigurtà
PIN to Unlock Screen

• PIN default: 9428
• Configurable to any numeric value
• Required to access settings or exit full-screen mode

PIN Popup Behavior

• Triggered when user swipes up from center bottom
• Available swipe directions:
  • Bottom to top
  • Fuq għal isfel

USB Lock

• Optional USB port disable feature
• Prevents unauthorized USB device access

PIN Entry Process

When accessing settings:

1. User swipes up from center bottom (IPad 2 Finger right to left gesture – No Pin code Support)
2. PIN entry dialog appears
3. Enter correct PIN using on-screen keypad
4. Access granted to settings interface

Pause and Resume Functionality
K-Agent jipprovdi kapaċitajiet ta' pawża u jerġa' jibda l-operazzjoni:

Waqqaf l-Operazzjoni

• Activated when PIN is entered and settings accessed
• Current UI is suspended
• Display returns to settings interface
• Session state preserved

Ibda l-Operazzjoni

• UI automatically reloads when exiting settings
• All interface states restored
• Continues until next PIN entry

 

Referenza API

K-Agent jipprovdi aċċess komprensiv għall-API għal ġestjoni u integrazzjoni remoti.

1. API Endpoints Overview
   • All API calls use the following format:
   • HTTP: http://<device_ip>:9803/<endpoint>
   • HTTPS: https://<device_ip>:9804/<endpoint>
2. Health and Status APIs
   • Kontroll tas-Saħħa
   • Endpoint: /health/ Method: GET Response: {“status”:”Up”} Description: Verify K-Agent is running and responsive
   • Example: https://192.168.88.73:9804/health/
3. URL APIs ta' Ġestjoni
   • Tnedija URL (Mhux Immersiv)
   • Punt tat-tmiem: /tnedijaurl?<URL> Metodu: GET Deskrizzjoni: Tnedija URL fil-modalità standard tal-browser
   • Example: https://192.168.88.73:9804/launchurl?http://192.168.88.253:8000/?interface=e84f5fb8-c5a3-4675-9006-d79d3e6cfe59&page=5913c07a-9a41-4fac-9870-e87b1ef719df
   • Tnedija ta' Kramer URL (Modalità Immersiva)
   • Punt tat-tmiem: /launchkramerurl?<URL> Metodu: GET Deskrizzjoni: Tnedija URL in full-screen immersive mode
   • Example: https://192.168.88.73:9804/launchkramerurl?http://192.168.88.253:8000/?interface=e84f5fb8-c5a3-4675-9006-d79d3e6cfe59&page=5913c07a-9a41-4fac-9870-e87b1ef719df&immersive=true
   • Pawża/Kompli AwtomatikamentURL
   • Pawża Endpoint: /pauselaunchautourl/ Punt tat-Tmiem tal-Kompliment: /resumelaunchautourl/ Metodu: GET Deskrizzjoni: Iwaqqaf jew kompli temporanjament URL tnedija awtomatika
   • Examples: https://192.168.88.73:9804/pauselaunchautourl/ https://192.168.88.73:9804/resumelaunchautourl/
   • Irrisettja URL
   • Punt tat-tmiem: /reseturl Metodu: GET Deskrizzjoni: Neħħi l-awto-URL settings u rrisettja l-password għad-default
   • Example: https://192.168.88.73:9804/reseturl
4. Popup Management APIs
   • Iftaħ il-Popup URL
   • Punt tat-tmiem: /popupurl Metodu: GET Deskrizzjoni: Iftaħ popup b'dak salvat URL
   • Example: https://192.168.88.73:9804/popupurl
   • Open Popup with Timer
   • Punt tat-tmiem: /popupurl?time=<seconds> Method: GET Description: Open popup for specified duration
   • You Can also Close the Popup by setting the time to 0
   • Example: https://192.168.88.73:9804/popupurl?time=5
   • Iftaħ il-Popup b' URL
   • Punt tat-tmiem: /popupurl?url=<URL> Metodu: GET Deskrizzjoni: Iftaħ popup b'informazzjoni speċifika URL (meta le URL saved)
   • Example: https://192.168.88.73:9804/popupurl?url= http://google.com
   • Iftaħ il-Popup b' URL & Tajmer
   • Punt tat-tmiem: /popupurl?url=<URL>&ħin= Metodu: GET Deskrizzjoni: Iftaħ popup b'informazzjoni speċifika URL (meta le URL salvat) għal tul ta' żmien speċifikat
   • Example: https://192.168.88.73:9804/popupurl?url= http://google.com&time=20
5. Display Control APIs (KT-20x Touch Panels)
   • Ippermetti/Iddiżattiva l-Kontroll tal-Wiri
   • Ippermetti: /displaysettingon/ Iddiżattiva: /displaysettingoff/ Metodu: GET Deskrizzjoni: Ippermetti jew iddiżattiva l-kontrolli tal-politika tal-wiri
   • Examples: https://192.168.88.73:9804/displaysettingon/  https://192.168.88.73:9804/displaysettingoff/
   • Konfigurazzjoni tal-Wiri
   • Issettja l-Ħin Mitfi tad-Displej: /setdisplayofftimevalue= Issettja l-Luminożità tal-Wiri: /setdisplaybrightnessvalue= Issettja l-Ħin tad-Dimming tal-Wiri: /setdisplaydimtime=
     Examples: https://192.168.88.73:9804/setdisplayofftimevalue=30 https://192.168.88.73:9804/setdisplaybrightnessvalue=75 https://192.168.88.73:9804/setdisplaydimtime=15
6. LED Control APIs (KT-20x Touch Panels)
   • Ibdel il-Kulur tad-Dawl LED
   • Punt tat-tmiem: /ledlightcolor=value(rgb1,rgb2,rgb3) Metodu: GET Deskrizzjoni: Issettja l-kulur tal-sidebar tal-LED billi tuża valuri RGB (0-255)
   • Example: https://192.168.88.73:9804/ledlightcolor=value(105,23,65)
   • Nota: Il-valuri RGB għandhom ikunu bejn 0-255
   • Check Full Screen Mode URL konfigurazzjoni
   • Use “Browse and select a URL” to verify Brain connectivity
   • Test manual URL dħul jekk l-iskoperta awtomatika tfalli

Display Policy Troubleshooting

1. Verify Display Policy is enabled
2. Check timeout values are properly configured
3. Test brightness controls via API
4. Confirm display responds to manual wake gestures

Migration from Kramer Control App

Fuqview
The Kramer Control App has been deprecated and replaced by K-Agent. All users should migrate to K-Agent for continued support and enhanced functionality.

Proċess ta' Migrazzjoni

Configuration Transfer

1. Identify Current URLs: Innota l-interfaċċja eżistenti tal-Kramer Control App URLs
2. Update K-Agent: Input URLs jużaw metodi ta' konfigurazzjoni K-Agent
3. Test Functionality: Verify all interfaces load correctly
4. Remove Old App: Uninstall deprecated Kramer Control App

Differenzi Ewlenin

Benefiċċji tal-Migrazzjoni

Funzjonalità Mtejba

• Comprehensive API for remote management
• Advanced display and power policies
• Improved security and access control

Better Integration

• Seamless Brain system connectivity
• Enhanced interface selection tools
• Improved error handling and diagnostics

Future Support

• Active development and updates
• Enhanced feature roadmap
• Continued compatibility with new Brain versions

Appendiċi

Default Settings Reference

Port Requirements Summary

URL Format Eż.amples

• Single Interface: http://192.168.1.100:8000/
• Multi-Interface with IDs: http://192.168.1.100:8000/?interface=43c286c8-ee1e-452f-b123-23afee72af1b&page=606cd9e0-9499-4d1f-8cf8-12441bee8c56
• Immersive Mode: http://192.168.1.100:8000/?interface=43c286c8-ee1e-452f-b123-23afee72af1b&page=606cd9e0-9499-4d1f-8cf8-12441bee8c56&immersive=true
• Għall-aħħar informazzjoni dwar il-prodotti tagħna u lista ta 'distributuri Kramer, żur tagħna websit fejn jistgħu jinstabu aġġornamenti għal dan il-manwal tal-utent.
• Aħna nilqgħu l-mistoqsijiet, il-kummenti u l-feedback tiegħek.
• It-termini HDMI, HDMI High-Definition Multimedia Interface, u l-Logo HDMI huma trademarks jew trademarks reġistrati ta’ HDMI Licensing Administrator, Inc.
• L-ismijiet tad-ditti, l-ismijiet tal-prodotti u t-trademarks kollha huma l-proprjetà tas-sidien rispettivi tagħhom.

Dokumenti / Riżorsi

App tal-K-Aġent Kramer [pdfManwal tal-Utent App tal-K-Agent, App

Referenzi

• Manwal għall-Utent