public final class

SmartRobot

org.smartrobot.android.SmartRobot

Class Overview

론처와 연결하거나 연결 해제하는 메소드를 정의한다.

다음은 로봇의 생명주기를 나타낸 것이다. 사각형 박스는 수행할 동작을 구현할 수 있는 콜백 함수를 나타내고, 색깔있는 둥근 사각형은 내부적으로 변경되는 상태를 나타낸다. onInitialized, onActivated, onExecute, onDeactivated, onDisposed는 각각 setOnInitialized(callback:Function), setOnActivated(callback:Function), setOnExecute(callback:Function), setOnDeactivated(callback:Function), setOnDisposed(callback:Function) 메소드로 설정한 콜백 함수를 나타낸다. 로봇을 구성하는 디바이스의 데이터는 onActivated() 콜백 함수가 호출된 이후부터 onDeactivated() 콜백 함수가 호출되기 전까지 읽거나 쓸 수 있다.

Summary

Public Methods
static Boolean activate()
론처와 연결한다.
static void deactivate()
론처와의 연결을 해제한다.
static void setOnActivated(callback:Function)
setOnInitialized(callback:Function) 메소드로 설정한 콜백 함수가 호출된 후에 애플리케이션이 론처에 연결되었을 때 호출되는 콜백 함수를 설정한다.
static void setOnDeactivated(callback:Function)
SmartRobot.deactivate() 메소드를 호출한 후 또는 론처가 종료되어, 애플리케이션이 론처에서 연결 해제되었을 때 호출되는 콜백 함수를 설정한다.
static void setOnDisposed(callback:Function)
론처가 종료되었을 때 호출되는 콜백 함수를 설정한다.
static void setOnExecute(callback:Function)
setOnActivated(callback:Function) 메소드로 설정한 콜백 함수가 호출된 이후부터 setOnDeactivated(callback:Function) 메소드로 설정한 콜백 함수가 호출되기 전까지 약 20ms마다 주기적으로 호출되는 콜백 함수를 설정한다.
static void setOnInitialized(callback:Function)
SmartRobot.activate() 메소드를 호출한 후에 로봇 객체가 생성되거나 로봇 객체가 변경되었을 때 호출되는 콜백 함수를 설정한다.
static void setOnNameChanged(callback:Function)
론처에서 현재 연결된 로봇의 이름을 변경했을 때 호출되는 콜백 함수를 설정한다.
static void setOnStateChanged(callback:Function)
하드웨어 로봇과 블루투스 연결 상태가 변경되었을 때 호출되는 콜백 함수를 설정한다.

Public Methods

public static function activate ():Boolean

라이브러리 버전 1.0.0부터

론처와 연결한다.

Returns
  • 성공하면 true, 아니면 false

public static function deactivate ():void

라이브러리 버전 1.0.0부터

론처와의 연결을 해제한다.

public static function setOnActivated (callback:Function):void

라이브러리 버전 1.0.0부터

setOnInitialized(callback:Function) 메소드로 설정한 콜백 함수가 호출된 후에 애플리케이션이 론처에 연결되었을 때 호출되는 콜백 함수를 설정한다.

콜백 함수는 SmartRobot.activate() 메소드를 호출하기 전에 설정해야 하며, function onActivated():void의 형태를 가져야 한다.

setOnActivated(callback:Function) 메소드로 설정한 콜백 함수가 호출된 이후부터 setOnDeactivated(callback:Function) 메소드로 설정한 콜백 함수가 호출되기 전까지 디바이스의 데이터를 읽거나 쓸 수 있으며, 약 20ms마다 주기적으로 setOnExecute(callback:Function) 메소드로 설정한 콜백 함수가 호출된다.

 SmartRobot.setOnActivated(onActivated);
 SmartRobot.activate();

 function onActivated():void
 {
 }
Parameters
callback 호출되는 콜백 함수

public static function setOnDeactivated (callback:Function):void

라이브러리 버전 1.0.0부터

SmartRobot.deactivate() 메소드를 호출한 후 또는 론처가 종료되어, 애플리케이션이 론처에서 연결 해제되었을 때 호출되는 콜백 함수를 설정한다.

콜백 함수는 SmartRobot.deactivate() 메소드를 호출하기 전에 설정해야 하며, function onDeactivated():void의 형태를 가져야 한다.

setOnDeactivated(callback:Function) 메소드로 설정한 콜백 함수가 호출된 이후에는 디바이스의 데이터를 읽거나 쓸 수 없다.

 SmartRobot.setOnDeactivated(onDeactivated);
 SmartRobot.activate();
 ...
 SmartRobot.deactivate();

 function onDeactivated():void
 {
 }
Parameters
callback 호출되는 콜백 함수

public static function setOnDisposed (callback:Function):void

라이브러리 버전 1.0.0부터

론처가 종료되었을 때 호출되는 콜백 함수를 설정한다.

콜백 함수는 SmartRobot.activate() 메소드를 호출하기 전에 설정해야 하며, function onDisposed():void의 형태를 가져야 한다.

 SmartRobot.setOnDisposed(onDisposed);
 SmartRobot.activate();

 function onDisposed():void
 {
 }
Parameters
callback 호출되는 콜백 함수

public static function setOnExecute (callback:Function):void

라이브러리 버전 1.0.0부터

setOnActivated(callback:Function) 메소드로 설정한 콜백 함수가 호출된 이후부터 setOnDeactivated(callback:Function) 메소드로 설정한 콜백 함수가 호출되기 전까지 약 20ms마다 주기적으로 호출되는 콜백 함수를 설정한다.

콜백 함수는 SmartRobot.activate() 메소드를 호출하기 전에 설정해야 하며, function onExecute():void의 형태를 가져야 한다.

setOnExecute(callback:Function) 메소드로 설정한 콜백 함수에서는 항상 디바이스의 데이터를 읽거나 쓸 수 있다.

 SmartRobot.setOnExecute(onExecute);
 SmartRobot.activate();

 function onExecute():void
 {
 }
Parameters
callback 호출되는 콜백 함수

public static function setOnInitialized (callback:Function):void

라이브러리 버전 1.0.0부터

SmartRobot.activate() 메소드를 호출한 후에 로봇 객체가 생성되거나 로봇 객체가 변경되었을 때 호출되는 콜백 함수를 설정한다.

즉, 로봇 객체가 새로 생성되었을 때, 론처에서 로봇을 변경하여 다른 로봇 객체로 변경되었을 때 호출되는 콜백 함수를 설정한다.

콜백 함수는 SmartRobot.activate() 메소드를 호출하기 전에 설정해야 하며, function onInitialized(robot:Robot):void의 형태를 가져야 한다.

 SmartRobot.setOnInitialized(onInitialized);
 SmartRobot.activate();

 function onInitialized(robot:Robot):void
 {
 }
Parameters
callback 호출되는 콜백 함수

public static function setOnNameChanged (callback:Function):void

라이브러리 버전 1.0.0부터

론처에서 현재 연결된 로봇의 이름을 변경했을 때 호출되는 콜백 함수를 설정한다.

콜백 함수는 SmartRobot.activate() 메소드를 호출하기 전에 설정해야 하며, function onNameChanged(name:String):void의 형태를 가져야 한다.

 SmartRobot.setOnNameChanged(onNameChanged);
 SmartRobot.activate();

 function onNameChanged(name:String):void
 {
 }
Parameters
callback 호출되는 콜백 함수

public static function setOnStateChanged (callback:Function):void

라이브러리 버전 1.0.0부터

하드웨어 로봇과 블루투스 연결 상태가 변경되었을 때 호출되는 콜백 함수를 설정한다.

콜백 함수는 SmartRobot.activate() 메소드를 호출하기 전에 설정해야 하며, function onStateChanged(state:int):void의 형태를 가져야 한다.

state가 가질 수 있는 값은 Robot 클래스에 정의되어 있다.

 SmartRobot.setOnStateChanged(onStateChanged);
 SmartRobot.activate();

 function onStateChanged(state:int):void
 {
 }