AllJoyn ABOUT ANNOUNCEMENT

ABOUT ANNOUNCEMENT

原文链接：https://allseenalliance.org/developers/learn/core/about-announcement

About Announcements 能够让设备或者应用在AllJoyn网络中声明自己，以便被其他设备和应用发现。 它共享以下信息：

· 易读的App和设备名称

· Make, Model, Version, Description

· 支持的语言

· 应用程序的图标

· 支持的对象和接口

· 服务端口数量

· 唯一识别App 和设备的ID

完整的列表请参考: Interface Definiton.

About特性支持很多语言，因此客户端可以很方便地可以采用用户希望的语言来显示。 通过About特性, 客户端可以发现网络上的设备和应用。 获得device/app的元数据, 发现它支持的服务, 获得device/app的图标，并用图标来代表device/app.

Concepts and Terminology

· 对于服务器来说. 设备或者应用使用About特性来声明自己.

· 对于客户端来说. 设备或者应用使用About特性来发现apps/devices.

How It Works

这里简要描述一下幕后发生的事情:

1. 

About服务器通过发送一个无会话信号来声明自己，包含的信息有：会话端口，对象和接口列表， About Announcement信息子集，应用和设备的名称，默认的语言，应用和设备的ID。

2. 

About客户端发现这个无会话的信号。然后就可以显示这个设备/应用的一些信息，它们的名称，以及支持的服务。

 

3. 

About客户端也可以选择连接上设备/应用的服务端口，然后获得更多信息，例如可以获得它的图标。

 

Learn More

· Learn more about the About Interface Definition

· Download the SDK, build and run the sample apps

· Learn more about the About APIs

 

 

 

 

ABOUT FEATURE INTERFACE DEFINITIONS

Release History

To access a previous version of this document, click the release version link below.

Release version

Date

What changed

14.02

2/28/2014

About interface version 1 was added.

14.06

6/30/2014

No updates.

14.06 Update 1

9/29/2014

· Updated the document title and Overview chapter title (changed from Specification to Definition)

· Added the release version number to the document title for version tracking.

· Added a note in the Definition Overview chapter to address the AllSeen Alliance Compliance and Certification program.

· Added a Mandatory column for method and signal parameters to support the AllSeen Alliance Compliance and Certification program.

14.12

12/17/2014

· Changed DeviceName from required to not required

· Additional clarification specifying the AppId must be 128-bit UUID as specified in RFC 4122

· Cleanup to make requirements for methods and signals more clear

· Icon interface was added. The icon interface has been part of AllJoyn™ and the About Feature since 14.02; however, the interface definition documentation was not added until 14.12.

Definition Overview

如下图所示，About接口由设备上的一个应用程序来实现。应用程序使用该接口广播自己，以便其他应用程序能够发现它。客户端应用程序和服务端应用程序之间的关系参见下图。

Figure: About feature architecture within the AllJoyn™ framework

注：所有方法和信号都是强制性的，以支持AllSeen联盟的合规和认证计划。

Discovery

应用程序使用无会话信号来发表声明，客户端通过声明来发现应用程序。声明中包括应用程序的基本信息，例如：应用名称，设备名称，制造商，和型号。声明中还包含对象路径和服务框架接口的列表，客户端可据此判断是否有自己感兴趣的功能。

除了无会话声明，About接口还提供了按需方法调用来检索应用程序未公布在声明中的所有可用元数据。