BlackBerry Messenger 플랫폼의 주요 클래스

클래스

설명

BBMPlatformContext

BBMPlatformContext 인터페이스를 사용해 프로그램의 액세스 상태를 확인하고 프로그램과 연결된 서비스(예: 메시징 서비스, 대화 상대 목록 서비스 및 UI 서비스)에 대한 참조를 검색할 수 있습니다.

프로그램이 BlackBerry Messenger 플랫폼에 등록되면 BlackBerry® Messenger 플랫폼은 BBMPlatformContext 인스턴스를 반환합니다.

BBMPlatformContextListener 클래스와 메서드를 확장하는 클래스를 정의하면 프로그램의 액세스 또는 등록 상태 변경에 대한 알림을 받을 수 있습니다.

MessagingService

MessagingService 클래스를 사용해 BBMPlatformChannel 또는 BBMPlatformSession 인스턴스를 만들고 대화 상대가 프로그램을 다운로드하도록 초대하고 BlackBerry Messenger 대화 상대에게 파일을 보낼 수 있습니다.

메시징 서비스와 관련된 이벤트 알림을 받으려면 MessagingServiceListener 추상 클래스를 확장하고, 콜백 메서드를 재정의하고 MessagingService.setServiceListener() 메서드를 호출해야 합니다.

프로그램과 연결된 MessagingService에 대한 참조를 검색하려면 BBMPlatformContext.getMessagingService()를 호출합니다.

BBMPlatformChannel

BBMPlatformChannel 인터페이스는 프로그램과 한 명 이상의 대화 상대 간의 비공개 연결을 나타냅니다. 프로그램이 여러 대화 상대와 통신 중일 경우 대화 상대들은 다른 대화 상대를 인식하지 않습니다. 따라서 대화 상대들은 다른 대화 상대가 아니라 프로그램과만 통신할 수 있습니다.

BBMPlatformConnection.setPublic()을 호출해 채널을 설정하면 BlackBerry Messenger 대화 상대 목록에 없는 대화 상대의 연결을 허용할 수 있습니다.

이벤트 및 채널 변경에 대한 알림을 받으려면 BBMPlatformChannelListener 클래스를 확장하고 BBMPlatformConnectionListener 클래스에서 상속된 콜백 메서드를 재정의해야 합니다.

BBMPlatformChannel의 인스턴스를 생성하려면 MessagingService.createChannel()을 호출하여 BBMPlatformChannelListener 인스턴스에 대한 참조를 전달합니다.

BBMPlatformSession

BBMPlatformSession 인터페이스는BlackBerry Messenger 대화 상대 간의 연결을 나타냅니다. 세션 연결을 생성할 때 세션의 대화 상대는 한 명 이상의 다른 대화 상대를 세션에 참여하도록 초대할 수 있습니다. 세션의 각 대화 상대는 데이터 공유가 가능합니다.

BBMPlatformConnection.setPublic()을 호출해 세션을 설정하면 BlackBerry Messenger 대화 상대 목록에 없는 대화 상대의 연결을 허용할 수 있습니다.

이벤트 및 세션 변경 사항에 대한 알림을 받으려면 BBMPlatformSessionListener 클래스를 확장하고 이 클래스의 콜백 메서드와 BBMPlatformConnectionListener 클래스에서 상속된 콜백 메서드를 재정의해야 합니다.

BBMPlatformSession의 인스턴스를 생성하려면 MessagingService.createSession()을 호출해 수신기를 할당할 BBMPlatformSessionListener 개체에 대한 참조를 전달합니다.

ContactListService

ContactListService 클래스는 사용자의 BlackBerry Messenger 대화 상대 목록에서 프로그램을 설치한 대화 상대에 액세스할 수 있게 합니다.

대화 상대 목록의 대화 상대 변경에 대한 알림을 받으려면 PresenceListener 인터페이스를 구현해야 합니다. PresenceListener에는 presenceUpdated() 콜백 메서드가 포함되어 있으며, 이 메서드는 대화 상대 목록의 대화 상대 중 한 명이 표시 사진, 표시 이름, 개인 메시지 또는 상태를 업데이트하면 호출됩니다.

프로그램의 ContactListService에 대한 참조를 검색하려면 BBMPlatformContext.getContactListService()를 호출합니다.

대화 상대 목록에 PresenceListener를 할당하려면 ContactListService.setListener(PresenceListener)를 호출합니다.

UIService

UIService 클래스는 프로그램별 메뉴 항목을BlackBerry Messenger에 추가하고, 사용자가 집합을 정의하여 이 집합에 따라 대화 상대를 선택할 수 있도록 하는 대화 상대 선택기에 액세스하고, 사용자의 BlackBerry Messenger 대화 상대 목록에 없는 대화 상대를 BBM™에 초대하거나 BlackBerry Messenger 채팅을 시작할 수 있는 메서드를 제공합니다.

프로그램의 UIService에 대한 참조를 검색하려면 BBMPlatformContext.getUIService()를 호출합니다.

MenuItemManager

MenuItemManager 클래스는 BlackBerry Messenger 대화 상대 목록 화면에서 메뉴 항목을 생성, 추가, 제거 및 확인할 수 있는 메서드를 제공합니다. 메뉴 항목은 선택한 대화 상대가 BlackBerry Messenger 연결 프로그램을 사용하여 사용자와 상호 작용할 수 있도록 초대하는 기능을 합니다.

선택한 대화 상대가 프로그램을 설치한 있는 경우에만 메뉴 항목이 표시됩니다.

새 메뉴 항목을 추가할 때 프로그램에 대한 메뉴 항목이 이미 있는 경우 기존 메뉴 항목을 덮어씁니다.


이 정보가 도움이 되었습니까? 의견을 보내 주십시오.