Schema.org 查询模式类型

下表列出了 Schema.org 为自定义设备操作定义的查询格式类型。每种类型的名称都以 $SchemaOrg 开头。这些类型对应于 Schema.org 中定义的标准类型。

其中一些类型会返回结构化数据，而不是单个值。下表中列出了这些类型。如需了解详情，请参阅结构化数据。

支持的 Schema.org 类型

类型	开发者模式示例	用户查询示例	支持结构化数据
$SchemaOrg_Date	在短信 Pro 上读出我从`$SchemaOrg_Date:my_date`发来的短信	在 sms Pro 上查看我 4 月 1 日的短信	是
$SchemaOrg_Number	让手电筒闪烁 `$SchemaOrg_Number:number` 次	让手电筒闪烁五次	否
$SchemaOrg_Time	在短信 Pro 上读出我从`$SchemaOrg_Time:my_time`发来的短信	从下午 5 点开始用 sms Pro 读出我的短信	是
$SchemaOrg_DateTime	在短信 Pro 上读出我从`$SchemaOrg_DateTime:my_time`发来的短信	在 sms Pro 上读出我昨天中午从那时开始的短信	是
$SchemaOrg_DayOfWeek	显示我的 `$SchemaOrg_DayOfWeek:day_of_week` 会议	显示我星期二的会议	否
$SchemaOrg_Color	打开`$SchemaOrg_Color:my_color`闪光灯	打开红色闪光灯	否
$SchemaOrg_priceCurrency	在货币应用上显示`$SchemaOrg_priceCurrency:cur`的汇率	在货币应用中显示日元的汇率	否
$SchemaOrg_Distance	显示“`$SchemaOrg_Distance:dist`”的转换图表	显示公里的换算图表	否
$SchemaOrg_Temperature	将温度设为 `$SchemaOrg_Number:num` 度 `$SchemaOrg_Temperature:temp`	将温度设为 70 华氏度	否
$SchemaOrg_Organization	观看`$SchemaOrg_Organization:organization`精彩集锦	观看湖人集锦	否
$SchemaOrg_Organization	显示`$SchemaOrg_Organization:organization`的股价	显示 Google 的股价	否
$SchemaOrg_Person	显示 `$SchemaOrg_Person:musician` 中排名前 10 的歌曲	显示最热门的 10 首布鲁诺火星歌曲	否
$SchemaOrg_Person	给我看看`$SchemaOrg_Person:person`的新闻	显示关于账单门槛的新闻	否
$SchemaOrg_Place	为`$SchemaOrg_Place:place`撰写评价	撰写关于纽约的评价	是
$SchemaOrg_Place	显示`$SchemaOrg_Place:location`的路况	显示山景城的路况信息	是
$SchemaOrg_Product	为`$SchemaOrg_Product:product`撰写评价	撰写 Google Glass 评价	否
$SchemaOrg_Book	阅读 `$SchemaOrg_Book:my_book` 上的文章	了解客户期望	否
$SchemaOrg_Movie	播放电影《`$SchemaOrg_Movie:my_movie`》	评价《卡萨布兰卡》影片	否
$SchemaOrg_TVSeries	播放《`$SchemaOrg_TVSeries:tv_series`》的下一集	播放下一集《朋友》	否
$SchemaOrg_servesCuisine	显示 `$SchemaOrg_servesCuisine:my_cuisine` 个餐馆	显示意大利餐馆	否
$SchemaOrg_MusicAlbum	把“`$SchemaOrg_MusicAlbum:album`”添加到我的队列中。	将《Abbey Road》添加到我的队列	否
$SchemaOrg_MusicRecording	将`$SchemaOrg_MusicRecording:song`添加到我的收藏夹。	无论你是否加入，都添加到我的收藏夹。	否
$SchemaOrg_YesNo	`$SchemaOrg_YesNo:yesno`	是	否
$SchemaOrg_网址	添加了 `$SchemaOrg_URL:url`	添加 google.com	否
$SchemaOrg_Email	添加了 `$SchemaOrg_Email:email`	添加 john@google.com	否
$SchemaOrg_PhoneNumber	添加了 `$SchemaOrg_PhoneNumber:phonenumber`	添加 (777) 777-7777	否
$SchemaOrg_Text	对方说的那首歌是什么？`$SchemaOrg_Text:text`	那是哪首歌说你是我的阳光？	否

结构化数据

某些类型支持传回结构化数据，而不是单个值。在 deviceExecution 部分，将 .structured 添加到参数名称中，以便接收以下类型的结构化数据：

"my-param-name": "$parameter-name.structured"

其中 my-param-name 是在 params 中传回的用户定义名称，parameter-name 用于标识查询格式中的参数。

请参阅以下示例：

地点

查询

为纽约撰写评价

操作包

...

"intent": {
    "name": "com.example.intents.Review",
    "parameters": [
        {
            "name": "place",
            "type": "SchemaOrg_Place"
        }
    ],
    "trigger": {
        "queryPatterns": [
            "write review for $SchemaOrg_Place:place"
        ]
    }
},

...

"deviceExecution": {
    "command": "com.example.commands.Review",
    "params": {
        "placeName": "$place.structured"
    }
}

...

返回的参数

有关详情，请参阅 LatLng。

"placeName": {
    "latitude": 40.7128,
    "longitude": 74.0060
}

日期

如需了解详情，请参阅日期。

返回的参数：

{
    "year": 2018,
    "month": 12,
    "day": 2
}

时间

如需了解详情，请参阅 TimeOfDay。

返回的参数：

{
    "hours": 12,
    "minutes": 0,
    "seconds": 0,
    "nanos": 0
}

DateTime

如需了解详情，请参阅 DateTime。

返回的参数：

{
    "date": {
      "year": 2018,
      "month": 11,
      "day": 30
    },
    "time": {
      "hours": 12,
      "minutes": 0,
      "seconds": 0,
      "nanos": 0
    }
}