Field

First, you have to Field Layout class:

      import com.infairy.cocina.SDK.Layout.Layout;
      import com.infairy.cocina.SDK.Layout.LayoutField;
      

Then, get Layout service

        Layout layout=(Layout)Tools.getService(context, Layout.class.getName(), "(FUNCTION=LAYOUT)");
      

Next, create layout tag and get LayoutID for other layout object used purpose:

            LayoutTag ltag=new LayoutTag();

            ltag.backgroundImage="img/background.png";
            ltag.bundleID=BundleID;
            ltag.LayoutHeight=450;
            ltag.LayoutWidth=800;
            ltag.title="My App";
            /*
             * Create layout tag and get layout id for other layout object use
             */
            LayoutID=layout.createUI(this, ltag);
      

Nex, create Field layout object:

          LayoutField lf=new LayoutField();
          lf.LayoutID=LayoutID;
          lf.left=81;
          lf.top=108;
          lf.width=157;
          lf.height=36;
          lf.fontColor="#000000";
          lf.fontSize=24;
          
          fID=layout.createUI(this, lf);

          
      

The Field layout can be clicked by users, you just need to do defined the key value:

          lf.key=device.DEVICE_OPERATION_USER_DEFINED_0;
      

"DEVICE_OPERATION_USER_DEFINED_0" is defined by com.infairy.cocina.SDK.device.DevicePool#DEVICE_OPERATION_xxx
then defined the Operation object( refer to Operation):

        public class myFirstBundle implements BundleActivator, Runnable{
            ...
           
           /*
            * Bundle ID
            */
           String BundleID="";
           
           /*
            * Layout ID
            */
           String LayoutID="";
           
           Thread me;

           /*
            * Layout object 
            */
           Layout layout;
           
          /*
           * entry point
           */
          public void start(BundleContext context) throws Exception {
              ...
              /*
               * get layout service
               */
              layout=(Layout)Tools.getService(context, Layout.class.getName(), "(FUNCTION=LAYOUT)");

              .....

              /*
               * define operation for layout key mapping
               */
              Vector Operation=new Vector();
              OperationDNA oobj=new OperationDNA();
              
              //when user click the image layout object, this operation object will trigger to run the Funtoin:Go()
              oobj.KEY=device.DEVICE_OPERATION_USER_DEFINED_0;   
              oobj.Function="Go";
              Operation.addElement(oobj);
              
              dict.put(InfairyInterface.DeviceOperation, Operation);

              ...
              
              BundleID=device.addDevice(this, dict);
            

You have also implemnt Go() function to catch up the action.

              public void Go(String value){
                ....
              }
            

The parameter "value" is field value which by user key in.

The Field layout object properties show as below:

          /**
           * layout id of bundle
           */
          public String LayoutID="";

          /**
           * Layout key defined, please refer to {@link com.infairy.cocina.SDK.device.DevicePool#DEVICE_OPERATION_DIMMER}, {@link com.infairy.cocina.SDK.device.DevicePool#DEVICE_OPERATION_xxx}...
           */
          public String key="";
          /**
           * layout width in pixel, default is 10
           */
          public int width=10;
          /**
           * layout height in pixel, default is 10
           */
          public int height=10;
          /**
           * layout axis of left, default is 0
           */
          public int left=0;
          /**
           * layout axis of top, default is 0
           */
          public int top=0;
          /**
           * layout key value, defined by developer
           */
          public String value="";
          /**
           * layout key index value, defined by developer
           */
          public String index="";
          /**
           * font color
           */
          public String fontColor="";
          /**
           * font size, default is 10
           */
          public int fontSize=10;
          /**
           * the field type is password or not, default is false 
           */
          public boolean isPassword=false;
          /**
           * the field is numeric of not, default is false
           */
          public boolean isNumber=false;
          /**
           * visibility, default is true
           */
          public boolean visible=true;