public interface

Robot

extends NamedElement
org.roboid.robot.NamedElement
   ↳ org.roboid.robot.Robot

Interface Overview

로봇을 구성하는 디바이스를 찾거나 리스너를 등록 및 제거하는 메소드를 정의한다.

Summary

Constants
int STATE_CONNECTED 하드웨어 로봇과 블루투스 통신이 연결되었음을 나타내는 상수.
int STATE_CONNECTING 하드웨어 로봇과 블루투스 통신을 연결 중임을 나타내는 상수.
int STATE_CONNECTION_LOST 하드웨어 로봇과 블루투스 통신 연결이 비정상적으로 끊어졌음을 나타내는 상수.
int STATE_DISCONNECTED 하드웨어 로봇과 블루투스 통신이 정상적으로 종료되었음을 나타내는 상수.
Public Methods
void addDeviceDataChangedListener(Device.DeviceDataChangedListener listener)
디바이스의 데이터가 갱신되었을 때 호출되도록 listener를 등록한다.
void clearDeviceDataChangedListener()
등록된 모든 리스너를 제거한다.
Device findDeviceById(int deviceId)
자식 디바이스 중에서 ID가 deviceId인 디바이스를 찾아 인스턴스를 반환한다.
Device findDeviceById(int productId, int deviceId)
제품 번호가 productId인 주변기기의 자식 디바이스 중에서 ID가 deviceId인 디바이스를 찾아 인스턴스를 반환한다.
String getId()
로봇의 ID를 반환한다.
void removeDeviceDataChangedListener(Device.DeviceDataChangedListener listener)
등록된 리스너 목록에서 listener를 제거한다.
Inherited Methods
From interface org.roboid.robot.NamedElement

Constants

public static final int STATE_CONNECTED

라이브러리 버전 1.0.0부터

하드웨어 로봇과 블루투스 통신이 연결되었음을 나타내는 상수.

  • 상수 값: 2

public static final int STATE_CONNECTING

라이브러리 버전 1.0.0부터

하드웨어 로봇과 블루투스 통신을 연결 중임을 나타내는 상수.

  • 상수 값: 1

public static final int STATE_CONNECTION_LOST

라이브러리 버전 1.0.0부터

하드웨어 로봇과 블루투스 통신 연결이 비정상적으로 끊어졌음을 나타내는 상수.

  • 상수 값: 3

public static final int STATE_DISCONNECTED

라이브러리 버전 1.0.0부터

하드웨어 로봇과 블루투스 통신이 정상적으로 종료되었음을 나타내는 상수.

  • 상수 값: 4

Public Methods

public void addDeviceDataChangedListener (Device.DeviceDataChangedListener listener)

라이브러리 버전 1.0.0부터

디바이스의 데이터가 갱신되었을 때 호출되도록 listener를 등록한다.

Parameters
listener 등록할 리스너

public void clearDeviceDataChangedListener ()

라이브러리 버전 1.0.0부터

등록된 모든 리스너를 제거한다.

public Device findDeviceById (int deviceId)

라이브러리 버전 1.0.0부터

자식 디바이스 중에서 ID가 deviceId인 디바이스를 찾아 인스턴스를 반환한다.

ID가 deviceId인 자식 디바이스가 없으면 null을 반환한다.

주변기기의 경우에는 findDeviceById(int productId, int deviceId) 메소드를 사용해야 한다.

 void someMethod(Robot robot)
 {
     Device leftWheel = robot.findDeviceById(Alpha.EFFECTOR_LEFT_WHEEL); // 알파 로봇의 왼쪽 바퀴 이펙터 디바이스를 찾는다.
 }
Parameters
deviceId 찾을 디바이스의 ID
Returns
  • 디바이스의 인스턴스 또는 null

public Device findDeviceById (int productId, int deviceId)

라이브러리 버전 1.0.0부터

제품 번호가 productId인 주변기기의 자식 디바이스 중에서 ID가 deviceId인 디바이스를 찾아 인스턴스를 반환한다.

ID가 deviceId인 자식 디바이스가 없으면 null을 반환한다.

로봇의 경우에는 findDeviceById(int deviceId) 메소드를 사용해야 한다.

 void someMethod(Robot robot)
 {
     Device button = robot.findDeviceById(1, Pen.EVENT_BUTTON); // 1번 펜의 버튼 이벤트 디바이스를 찾는다.
 }
Parameters
productId 제품 번호
deviceId 찾을 디바이스의 ID
Returns
  • 디바이스의 인스턴스 또는 null

public String getId ()

라이브러리 버전 1.0.0부터

로봇의 ID를 반환한다.

Returns
  • 로봇의 ID

public void removeDeviceDataChangedListener (Device.DeviceDataChangedListener listener)

라이브러리 버전 1.0.0부터

등록된 리스너 목록에서 listener를 제거한다.

Parameters
listener 제거할 리스너