Sistemde Sesli İşlem, artık Asistan'la entegrasyon için önerilen bir yol değildir. Alternatif derlemeler hakkında daha fazla bilgi için lütfen Uygulama İşlemleri dokümanlarına bakın.

Sistem Sesli İşlem'lerini Kullanmaya Başlayın

Google Sesli İşlem, söylenen ve yazılan birçok işlem isteğini tanır ve bunlar için Android amaçları oluşturur. Play Müzik ve Keep gibi uygulamalar bu bildirimleri alabilir ve istenen işlemi gerçekleştirebilir. Uygulamanız şu işlemlerin bazıları için de destek bildirebilir:

  1. Niyet filtresi tanımlayın
  2. Uygulamanızın amacını ele alın
  3. Uygulamanızın tamamlanma durumunu güncelleme

Desteklenen sistem işlemlerinin ayrıntılı listesi için System Actions Reference (Sistem işlemleri referansı) başlıklı makaleyi inceleyin.

1. Adım: Amaç filtresi tanımlayın

Uygulamanızın bir veya daha fazla sistem işlemini desteklediğini belirtmek için uygulamanızın manifest dosyasına her işlem için bir intent filtresi ekleyin.

Örneğin, uygulamanız alarm ayarlayabiliyorsa manifest dosyanıza aşağıdaki amaç filtresini ekleyin:

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.SET_ALARM"/>
        <category android:name="android.intent.category.DEFAULT"/>
    </intent-filter>
</activity>

Kullanıcının Alarm Ayarla amacını işleyebilen birden çok uygulaması varsa Google Sesli İşlem, kullanıcının işlemi tamamlamak için uygulamayı seçmesine olanak tanır:

Bir uygulamayı çağıran Google sesli işlemlerini gösteren resim

Şekil 1: Sesli İşlemler, kullanıcıların sistem işlemlerini destekleyen uygulamalar arasından seçim yapmasına olanak tanır.

2. Adım: Uygulamanızın amacını ele alın

Uygulamanız amacı aldığında, işlemi gerçekleştirmesi gerekir. Bu örnekte alarmı ayarlamalıdır. Aşağıdaki kod örneğini inceleyin.

3. Adım: Uygulamanızın tamamlanma durumunu güncelleyin

App Indexing API, tamamlanan uygulama etkinliklerini Google'a göndermenizi sağlar. Google, daha sonra Google uygulamasındaki sorgu otomatik tamamlamaları sayesinde içeriğinizi kullanıcılara yeniden gösterebilir.

Uygulamanız işlemi gerçekleştirdikten sonra uygun bir işlem türüyle (ör. Action.TYPE_ADD) AppIndexApi.end() yöntemini çağırın.

İşlemin başarıyla tamamlanıp tamamlanmadığını bildirmek için uygun işlem durumu türünü de ayarlamanız gerekir. Belirli bir işlemin durumunu ayarlamak için setActionStatus yöntemini kullanabilirsiniz.

Gelen amacın nasıl ele alınacağını ve kullanıcının bir alarmı başarıyla kurduğunu bildirmek için App Indexing API'sini nasıl kullanacağınızı gösteren eksiksiz bir örneği burada bulabilirsiniz:

public class MainActivity extends Activity {

    private static final Uri ALARM_URI = Uri.parse("android-app://com.myclockapp/set_alarm_page");

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        ...

        // Get the intent
        Intent intent = getIntent();
        if (AlarmClock.ACTION_SET_ALARM.equals(intent.getAction())) {
            if (intent.hasExtra(AlarmClock.EXTRA_HOUR)) {
                // Step 2: get the rest of the intent extras and set an alarm
                ...
            }

            // Step 3: report the action through the App Indexing API
            Thing alarm = new Thing.Builder()
                    .setName("Alarm for 4:00 PM")
                    .setDescription("Alarm set for 4:00 PM, with the 'Argon' ringtone"
                                    + " and vibrate turned on.")
                    .setUrl(APP_URI)
                    .build();

            Action setAlarmAction = new Action.Builder(Action.TYPE_ADD)
                    .setObject(alarm)
                    .setActionStatus(Action.STATUS_TYPE_COMPLETED)
                    .build();

            AppIndex.AppIndexApi.end(mClient, setAlarmAction);
        }
    }

    ...

}

Sistem işlemleri referansı

Google Voice İşlemleri, aşağıdaki tablolarda listelenen işlemlerden herhangi birini algıladığında bir niyeti tetikler.

Alarm işlemleri

İşlem Örnek Komut
Alarm ayarlama sabah 6:00'ya alarm kur
Zamanlayıcı ayarlama 5 dakikalık zamanlayıcı ayarla

İletişim işlemleri

İşlem Örnek Komut
Telefon araması başlatma 555-5555'i ara
starbucks'ı ara
annemi ara
sesli mesajı ara

Arama işlemleri yalnızca yerleşik çeviriciye sahip cihazlarda (telefon gibi) ve telefonla arama özelliğini destekleyen uygulamaların (VoIP uygulaması olan tablet gibi) cihazlarda tetiklendiği durumlar.

Fitness işlemleri

İşlem Örnek Komut
Bisiklet yolculuğu başlatma/durdurma bisiklet gezisi başlat
Koşu başlatma/durdurma koşu başlat
Antrenman başlatma/durdurma Antrenman başlat
Kalp atışını göster nabız göster
Adım sayısını göster adım sayısını göster

Yerel işlemler

İşlem Örnek Komut
Taksit rezervasyonu yapma kabin rezervasyonu

Taksit rezervasyonu işlemi yalnızca Android Wear'da tetiklenir.

Medya işlemleri

İşlem Örnek Komut
Aramadan müzik çalma michael jackson faturaie jean oyna
müzik çal
klasik müzik çal
duvardan çık
vnstreamer'da pembe bot çal
Fotoğraf çek resim çek
Video kaydetme video kaydet

İşlemleri açın

İşlem Örnek Komut
Açık URL twitter.com'u aç
Uygulama Açın Twitter'ı aç (Varsayılan olarak çalışır, belirli bir amaç yoktur.)

Üretkenlik işlemleri

İşlem Örnek Komut
Not alın Market alışverişi yap

Arama işlemleri

İşlem Örnek Komut
Belirli bir uygulamayı kullanarak arama yapma youtube'da kedi videosu ara