music_playback

macOS

Amaç

Music uygulamasında oynatmayı denetler. action: play (sürdürür; `track_id` ile o kitaplık parçasını, `playlist` ile o çalma listesini oynatır), pause, next, previous veya volume (`volume` değerini 0 ile 100 arasında ayarlar). confirm olmadan çağrılırsa önizleme döndürür ve hiçbir şeyi değiştirmez; yapmak için confirm=true iletin. Sonrasında oynatıcı durumunu, ses düzeyini ve geçerli parçayı döndürür. Music uygulaması açık değilken pause, next, previous ve volume hiçbir şey yapmaz; play uygulamayı açar.

Zorunlu girdiler

• action

Girdi adları aracın istediği biçimde aynen korunur. İngilizce kanonik teknik tanımlar aşağıdaki açılır şemadadır.

İzinler ve onay

Şema açık bir onay parametresi bildirir. Önizlemeyi inceleyin ve gerçek işlemi platform sözleşmesine göre yetkilendirin.

• Yalnızca kullanıcının bu platformda yetkilendirdiği uygulamaları, hesapları ve kaynakları kullanın. Bağlantı ve izin gereksinimleri için bu aracın platforma özgü açıklamasına bakın; bu katalog ek OAuth kapsamları veya OS yetkileri bulunduğunu ileri sürmez.

{
  "properties": {
    "action": {
      "description": "What to do.",
      "enum": [
        "play",
        "pause",
        "next",
        "previous",
        "volume"
      ],
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to act. Without it, returns a preview and changes nothing.",
      "type": "boolean"
    },
    "playlist": {
      "description": "With play: a playlist name or id from music_list_playlists.",
      "type": "string"
    },
    "track_id": {
      "description": "With play: a track id from music_search_library.",
      "type": "string"
    },
    "volume": {
      "description": "With volume: 0 to 100.",
      "type": "integer"
    }
  },
  "required": [
    "action"
  ],
  "type": "object"
}

Belge örneği

music_playback için örnek belge. Bu örneği çalıştırmayın. Gösterilen bağımsız değişkenler kurgusal bir veri kümesine aittir; gerçek bir çağrıdan önce gerçek tanıtıcıları bulun ve izin alın.

{
  "action": "play",
  "confirm": false,
  "playlist": "Demo Focus"
}