Bu sayfa, Cloud Translation API ile çevrilmiştir.

Takvim sağlayıcısına genel bakış

Takvim Sağlayıcı, kullanıcının takvim etkinliklerinin depolandığı bir veri havuzudur. Takvim Sağlayıcı API'si; takvimler, etkinlikler, katılımcılar, hatırlatıcılar vb. üzerinde sorgu, ekleme, güncelleme ve silme işlemleri yapmanıza olanak tanır.

Takvim Sağlayıcı API'si, uygulamalar ve senkronizasyon bağdaştırıcılar tarafından kullanılabilir. İlgili içeriği oluşturmak için kullanılan kuralları, çağrı yapan programın türüne göre değişir. Bu doküman, öncelikle Takvim Sağlayıcı API'sinin uygulama olarak kullanılmasına odaklanır. Senkronizasyon adaptörlerinin farklılıkları hakkında bilgi edinmek için Senkronizasyon Adaptörleri başlıklı makaleyi inceleyin.

Normalde takvim verilerini okumak veya yazmak için bir uygulamanın manifesti Kullanıcı bölümünde açıklandığı üzere İzinler. Google Takvim, sık yapılan işlemleri kolaylaştırmak için Sağlayıcı, Takvim'de açıklandığı gibi bir dizi amaç sunar. Intent'ler. Bu amaçlar; kullanıcıları, eklemek, görüntülemek, ve etkinlikleri düzenleyebilirsiniz. Kullanıcı, Takvim uygulamasıyla etkileşimde bulunur ve ardından orijinal uygulamaya geri döner. Bu nedenle, uygulamanızın izin istemesi veya etkinlikleri görüntülemek ya da oluşturmak için bir kullanıcı arayüzü sağlaması gerekmez.

Temel Bilgiler

İçerik sağlayıcılar verileri depolar ve uygulamalara erişilebilir hale getirir. Android platformu tarafından sunulan içerik sağlayıcılar (Takvim Sağlayıcı dahil), verileri genellikle her satırın bir kayıt ve her sütunun belirli bir tür ve anlama sahip veriler olduğu ilişkisel veritabanı modeline dayalı bir tablo grubu olarak gösterir. Calendar Provider API'si aracılığıyla uygulamalar ve senkronizasyon bağdaştırıcıları, çalıştırılabilir bir kullanıcının takvim verileri.

Her içerik sağlayıcı, veri kümesini benzersiz şekilde tanımlayan herkese açık bir URI (Uri nesnesi olarak sarmalanır) sağlar. Birden fazla veri kümesini (birden fazla tablo) kontrol eden bir içerik sağlayıcı, her biri için ayrı bir URI gösterir. Tümü Sağlayıcılara ilişkin URI'ler "content://" dizesiyle başlar. Bu Verilerin bir içerik sağlayıcı tarafından kontrol edildiğini tanımlar. Takvim Sağlayıcı, sınıflarının (tablolar) her biri için URI'ler için sabitler tanımlar. Bu URI'ler <class>.CONTENT_URI biçimindedir. Örneğin, örnek, Events.CONTENT_URI.

Şekil 1'de Takvim Sağlayıcı veri modelinin grafiksel gösterimi gösterilmektedir. Ana tabloları ve bunları birbirine bağlayan alanları gösterir.

Şekil 1. Takvim Sağlayıcı veri modeli.

Bir kullanıcının birden çok takvimi olabilir ve farklı takvimler farklı hesap türleriyle (Google Takvim, Exchange vb.) ilişkilendirilebilir.

CalendarContract, takvim ve etkinlikle ilgili bilgilerin veri modelini tanımlar. Bu veriler, aşağıda listelenen bir dizi tabloda depolanır.

Tablo (Sınıf)	Açıklama
`CalendarContract.Calendars`	Bu tabloda takvime özgü bilgileri ekleyin. Bu tablodaki her satır, tek bir takvimin ayrıntılarını (ör. ad, renk, senkronizasyon bilgileri) içerir.
`CalendarContract.Events`	Bu tabloda belirli bilgileri sağlar. Bu tablodaki her satırda tek bir etkinliğe ait bilgiler (ör. etkinlik başlığı, konum, başlangıç zamanı, bitiş zamanı vb.) bulunur. Etkinlik tek seferlik veya birden fazla kez tekrarlanabilir. Katılımcılar hatırlatıcılar ve genişletilmiş özellikler ayrı tablolarda saklanır. Her birinin, Etkinlikler tablosundaki `_ID` değerine referans veren bir `EVENT_ID` değeri vardır.
`CalendarContract.Instances`	Bu tabloda başlangıç ve bitiş zamanını ayarlayın. Bu tablodaki her satır tek bir etkinlik oluşumunu temsil eder. Tek seferlik etkinliklerde örneklerin etkinliklerle 1:1 eşlemesi vardır. Yinelenen etkinlikler için, söz konusu etkinliğin birden çok gerçekleşmesine karşılık gelen birden fazla satır otomatik olarak oluşturulur.
`CalendarContract.Attendees`	Bu tabloda etkinlik katılımcısı (konuk) bilgileri yer alır. Her satır, bir etkinliğin tek bir konuğunu temsil eder. Davetlinin türünü ve davetlinin katılım yanıtını belirtir bu etkinlikten bahsedeceğiz.
`CalendarContract.Reminders`	Bu tabloda uyarı/bildirim verileri bulunur. Her satır, bir etkinlik için tek bir uyarıyı temsil eder. etkinliğin birden fazla hatırlatıcısı olabilir. Etkinlik başına maksimum hatırlatıcı sayısı: belirtilen `MAX_REMINDERS` Bu veri, Search Ads 360'ı kullanan belirtilen takvimin sahibi olur. Hatırlatıcılar, etkinlikten dakikalar önce belirtilir ve kullanıcıya nasıl uyarılacağını belirleyen bir yöntem içerir.

Calendar Provider API'si esnek ve güçlü olacak şekilde tasarlanmıştır. Şurada: aynı zamanda iyi bir son kullanıcı deneyimi sunmak ve Takvimin ve verilerinin bütünlüğünü korumak için. Bu nedenle, API'yi kullanırken aklınızda bulundurmanız gereken bazı noktalar aşağıda belirtilmiştir:

Takvim etkinlikleri ekleme, güncelleme ve görüntüleme. Takvim sağlayıcısından doğrudan etkinlik eklemek, değiştirmek ve okumak için uygun izinlere sahip olmanız gerekir. Ancak tam teşekküllü bir takvim uygulaması veya senkronizasyon bağdaştırıcısı oluşturmuyorsanız bu izinleri istemeniz gerekmez. Bunun yerine, okuma ve yazma işlemlerini Android'in Takvim uygulamasına aktarmak için Android'in Takvim uygulaması tarafından desteklenen intent'leri kullanabilirsiniz. Intent'leri kullandığınızda uygulamanız, kullanıcıları önceden doldurulmuş bir formda istenen işlemi gerçekleştirmek için Takvim uygulamasına gönderir. İşlem tamamlandıktan sonra uygulamanıza geri gönderilir. Uygulamanızı, Takvim üzerinden genel işlemleri gerçekleştirecek şekilde tasarladığınızda kullanıcılara tutarlı, sağlam bir kullanıcı arayüzü sunarsınız. Bu, önerilen yaklaşımdır. Daha fazla bilgi için Takvim intent'leri başlıklı makaleyi inceleyin.
Senkronizasyon adaptörleri Senkronizasyon bağdaştırıcısı, kullanıcının cihazındaki takvim verilerini başka bir sunucu veya veri kaynağıyla senkronize eder. CalendarContract.Calendars ve CalendarContract.Events tablolarında, senkronizasyon bağdaştırıcıların kullanması için ayrılmış sütunlar vardır. Sağlayıcı ve uygulamalar bunları değiştirmemelidir. Hatta senkronizasyon bağdaştırıcısı olarak erişilmediği sürece görünmezler. Daha fazla bilgi için senkronizasyon adaptörleri için Senkronizasyon Bağdaştırıcıları bölümüne bakın.

Kullanıcı izinleri

Takvim verilerini okumak için bir uygulamanın manifest dosyasına READ_CALENDAR iznini eklemesi gerekir. Takvim verilerini silme, ekleme veya güncelleme WRITE_CALENDAR iznini içermelidir:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"...>
    <uses-sdk android:minSdkVersion="14" />
    <uses-permission android:name="android.permission.READ_CALENDAR" />
    <uses-permission android:name="android.permission.WRITE_CALENDAR" />
    ...
</manifest>

Takvim tablosu

CalendarContract.Calendars tablosu ayrıntıları içerir ayrı ayrı takvimler oluşturabilirsiniz. Aşağıdakiler Takvim sütunları hem bir uygulama hem de bir senkronizasyon bağdaştırıcısı tarafından yazılabilir. Desteklenen alanların tam listesi için CalendarContract.Calendars referansına bakın.

Sabit	Açıklama
`NAME`	Takvimin adı.
`CALENDAR_DISPLAY_NAME`	Bu takvimin kullanıcıya gösterilecek adı.
`VISIBLE`	Takvimin görüntülenmek için seçili olup olmadığını gösteren boole değeri. 0 değeri, bu takvimle ilişkili etkinliklerin gösterilmemesi gerektiğini gösterir. 1 değeri, bu takvimle ilişkili etkinliklerin şu tarihte yapılması gerektiğini belirtir: gösterilebilir. Bu değer, `CalendarContract.Instances` tablosunda satır oluşturmayı etkiler.
`SYNC_EVENTS`	Takvimde senkronizasyon yapılıp yapılmaması ve etkinliklerin cihazda depolanıp depolanmaması gerektiğini belirten bir boole değeri. 0 değeri, "bu takvimi senkronize etme" anlamına gelir. bu etkinlikleri cihazda depolamasını sağlar. 1 değeri, bu takvimdeki etkinlikleri senkronize ettiğini gösterir ve etkinliklerini cihazda depolamasını sağlar.

Tüm işlemler için bir hesap türü ekleyin

Calendars.ACCOUNT_NAME ile ilgili sorgu yapıyorsanız Calendars.ACCOUNT_TYPE'u da seçime dahil etmeniz gerekir. Bunun nedeni, belirli bir hesabın yalnızca ACCOUNT_NAME ve ACCOUNT_TYPE değerlerine göre benzersiz olarak kabul edilmesidir. ACCOUNT_TYPE, hesap AccountManager'a kaydedilirken kullanılan hesap kimlik doğrulayıcısına karşılık gelen dizedir. Cihaz hesabıyla ilişkili olmayan takvimler için ACCOUNT_TYPE_LOCAL adlı özel bir hesap türü de vardır. ACCOUNT_TYPE_LOCAL hesap alınamıyor senkronize edildi.

Takvim sorgulaması

Belirli bir kişiye ait takvimlerin nasıl alınacağını gösteren bir örnek belirtir. Basitlik açısından bu örnekte sorgu işlemi kullanıcı arayüzü mesaj dizisinde ("ana mesaj dizisi") gösterilmektedir. Pratikte bu, eş zamanlı olmayan bir birincil ileti dizisidir. Daha fazla tartışma için bkz. Yükleyiciler. Verileri yalnızca okumakla kalmıyor, aynı zamanda değiştiriyorsanız AsyncQueryHandler bölümüne bakın.

Kotlin

// Projection array. Creating indices for this array instead of doing
// dynamic lookups improves performance.
private val EVENT_PROJECTION: Array<String> = arrayOf(
        CalendarContract.Calendars._ID,                     // 0
        CalendarContract.Calendars.ACCOUNT_NAME,            // 1
        CalendarContract.Calendars.CALENDAR_DISPLAY_NAME,   // 2
        CalendarContract.Calendars.OWNER_ACCOUNT            // 3
)

// The indices for the projection array above.
private const val PROJECTION_ID_INDEX: Int = 0
private const val PROJECTION_ACCOUNT_NAME_INDEX: Int = 1
private const val PROJECTION_DISPLAY_NAME_INDEX: Int = 2
private const val PROJECTION_OWNER_ACCOUNT_INDEX: Int = 3

Java

// Projection array. Creating indices for this array instead of doing
// dynamic lookups improves performance.
public static final String[] EVENT_PROJECTION = new String[] {
    Calendars._ID,                           // 0
    Calendars.ACCOUNT_NAME,                  // 1
    Calendars.CALENDAR_DISPLAY_NAME,         // 2
    Calendars.OWNER_ACCOUNT                  // 3
};

// The indices for the projection array above.
private static final int PROJECTION_ID_INDEX = 0;
private static final int PROJECTION_ACCOUNT_NAME_INDEX = 1;
private static final int PROJECTION_DISPLAY_NAME_INDEX = 2;
private static final int PROJECTION_OWNER_ACCOUNT_INDEX = 3;

Örneğin bir sonraki bölümünde sorgunuzu oluşturursunuz. Seçim, sorgu için ölçütleri belirtir. Bu örnekte sorgu, ACCOUNT_NAME"hera@example.com", ACCOUNT_TYPE"com.example" ve OWNER_ACCOUNT"hera@example.com" içeren takvimleri arar. Bir kullanıcının yalnızca sahip olduğu takvimleri değil, görüntülediği tüm takvimleri görmek istiyorsanız OWNER_ACCOUNT öğesini çıkarın. Sorgu, veritabanı sorgusu tarafından döndürülen sonuç kümesini incelemek için kullanabileceğiniz bir Cursor nesnesi döndürür. İçerik sağlayıcılarda sorgu kullanma hakkında daha fazla bilgi için İçerik Sağlayıcılar başlıklı makaleyi inceleyin.

Kotlin

// Run query
val uri: Uri = CalendarContract.Calendars.CONTENT_URI
val selection: String = "((${CalendarContract.Calendars.ACCOUNT_NAME} = ?) AND (" +
        "${CalendarContract.Calendars.ACCOUNT_TYPE} = ?) AND (" +
        "${CalendarContract.Calendars.OWNER_ACCOUNT} = ?))"
val selectionArgs: Array<String> = arrayOf("hera@example.com", "com.example", "hera@example.com")
val cur: Cursor = contentResolver.query(uri, EVENT_PROJECTION, selection, selectionArgs, null)

Java

// Run query
Cursor cur = null;
ContentResolver cr = getContentResolver();
Uri uri = Calendars.CONTENT_URI;
String selection = "((" + Calendars.ACCOUNT_NAME + " = ?) AND ("
                        + Calendars.ACCOUNT_TYPE + " = ?) AND ("
                        + Calendars.OWNER_ACCOUNT + " = ?))";
String[] selectionArgs = new String[] {"hera@example.com", "com.example",
        "hera@example.com"};
// Submit the query and get a Cursor object back.
cur = cr.query(uri, EVENT_PROJECTION, selection, selectionArgs, null);

Sonraki bölümde, sonuç kümesinde gezinmek için imleç kullanılır. Şunu kullanır: değerleri döndürmek için örneğin başında ayarlanan sabit değerler tıklayın.

Kotlin

// Use the cursor to step through the returned records
while (cur.moveToNext()) {
    // Get the field values
    val calID: Long = cur.getLong(PROJECTION_ID_INDEX)
    val displayName: String = cur.getString(PROJECTION_DISPLAY_NAME_INDEX)
    val accountName: String = cur.getString(PROJECTION_ACCOUNT_NAME_INDEX)
    val ownerName: String = cur.getString(PROJECTION_OWNER_ACCOUNT_INDEX)
    // Do something with the values...
}

Java

// Use the cursor to step through the returned records
while (cur.moveToNext()) {
    long calID = 0;
    String displayName = null;
    String accountName = null;
    String ownerName = null;

    // Get the field values
    calID = cur.getLong(PROJECTION_ID_INDEX);
    displayName = cur.getString(PROJECTION_DISPLAY_NAME_INDEX);
    accountName = cur.getString(PROJECTION_ACCOUNT_NAME_INDEX);
    ownerName = cur.getString(PROJECTION_OWNER_ACCOUNT_INDEX);

    // Do something with the values...

   ...
}

Takvimde değişiklik yapma

Bir takvimi güncellemek için takvimin _ID değerini Uri'ye eklenmiş bir kimlik olarak (withAppendedId()) veya ilk seçim öğesi olarak sağlayabilirsiniz. Seçim "_id=?" ile başlamalı ve ilk selectionArg, takvimin _ID bölümü olmalıdır. Kimliği URI'de kodlayarak da güncelleme yapabilirsiniz. Bu örnekte, (withAppendedId()) yaklaşımı kullanılarak bir takvimin görünen adı değiştirilmektedir:

Kotlin

const val DEBUG_TAG: String = "MyActivity"
...
val calID: Long = 2
val values = ContentValues().apply {
    // The new display name for the calendar
    put(CalendarContract.Calendars.CALENDAR_DISPLAY_NAME, "Trevor's Calendar")
}
val updateUri: Uri = ContentUris.withAppendedId(CalendarContract.Calendars.CONTENT_URI, calID)
val rows: Int = contentResolver.update(updateUri, values, null, null)
Log.i(DEBUG_TAG, "Rows updated: $rows")

Java

private static final String DEBUG_TAG = "MyActivity";
...
long calID = 2;
ContentValues values = new ContentValues();
// The new display name for the calendar
values.put(Calendars.CALENDAR_DISPLAY_NAME, "Trevor's Calendar");
Uri updateUri = ContentUris.withAppendedId(Calendars.CONTENT_URI, calID);
int rows = getContentResolver().update(updateUri, values, null, null);
Log.i(DEBUG_TAG, "Rows updated: " + rows);

Takvim ekleme

Takvimler öncelikle bir senkronizasyon bağdaştırıcısı tarafından yönetilecek şekilde tasarlanmıştır. Bu nedenle, yalnızca senkronizasyon bağdaştırıcısı olarak yeni takvimler eklemeniz gerekir. Çoğunlukla, uygulamalar yalnızca takvimlerde görünen adı değiştirmek gibi yüzeysel değişiklikler yapabilir. Bir uygulamanın yerel takvim oluşturması gerekiyorsa bunu ACCOUNT_TYPE_LOCAL ACCOUNT_TYPE kullanarak takvim eklemeyi senkronizasyon bağdaştırıcısı olarak gerçekleştirerek yapabilir. ACCOUNT_TYPE_LOCAL. olmayan takvimler için özel bir hesap türüdür bir cihaz hesabıyla ilişkilendirilmiş. Bu türdeki takvimler sunucuyla senkronize edilmez. Senkronizasyon adaptörleriyle ilgili bilgi için Senkronizasyon Adaptörleri başlıklı makaleyi inceleyin.

Etkinlikler tablosu

CalendarContract.Events tablosu, tek tek etkinliklerle ilgili ayrıntıları içerir. Etkinlik eklemek, güncellemek veya silmek için bir uygulamanın WRITE_CALENDAR iznini kendi manifest dosyanız oluşturun.

Aşağıdaki Etkinlikler sütunları hem uygulama hem de senkronizasyon bağdaştırıcısı tarafından yazılabilir. Desteklenen alanların tam listesi için CalendarContract.Events referansına bakın.

Sabit	Açıklama
`CALENDAR_ID`	Etkinliğin ait olduğu takvimin `_ID`.
`ORGANIZER`	Etkinliği düzenleyen kişinin (sahibinin) e-posta adresi.
`TITLE`	Etkinliğin başlığı.
`EVENT_LOCATION`	Etkinliğin gerçekleştiği yer.
`DESCRIPTION`	Etkinliğin açıklaması.
`DTSTART`	Etkinliğin başladığı zaman (UTC milisaniye cinsinden, sıfır zamandan itibaren).
`DTEND`	Dönemden bu yana etkinliğin UTC milisaniye cinsinden sona erdiği zaman.
`EVENT_TIMEZONE`	Etkinliğin saat dilimi.
`EVENT_END_TIMEZONE`	Etkinliğin bitiş saatinin saat dilimi.
`DURATION`	Etkinliğin süresi (RFC5545 biçiminde). Örneğin, `"PT1H"` değeri etkinliğin bir saat süreceğini, `"P2W"` değeri ise 2 haftalık bir süreyi belirtir.
`ALL_DAY`	1 değeri, yerel saat diliminizi seçin. 0 değeri, bir gün içinde herhangi bir zamanda başlayıp bitebilecek normal bir etkinlik olduğunu gösterir.
`RRULE`	Etkinlik biçimi için yineleme kuralı. Örneğin, örnek, `"FREQ=WEEKLY;COUNT=10;WKST=SU"`. Daha fazla burada daha fazla örnek bulabilirsiniz.
`RDATE`	Etkinliğin yinelenme tarihleri. Genellikle `RDATE` kullanıyorsunuz `RRULE` ile birlikte toplam kümeyi tanımlamak tekrarlayan örneklerdir. Daha fazla bilgi için RFC5545 spesifikasyonuna bakın.
`AVAILABILITY`	Bu etkinlik meşgul zaman olarak sayılır veya planlama yapılabilir boş zaman ise.
`GUESTS_CAN_MODIFY`	Davetlilerin etkinliği değiştirip değiştiremeyeceğini belirtir.
`GUESTS_CAN_INVITE_OTHERS`	Davetlilerin başka kullanıcıları davet edip edemeyeceği.
`GUESTS_CAN_SEE_GUESTS`	Davetlilerin katılımcı listesini görüp göremeyeceği.

Etkinlik ekleme

Uygulamanız yeni bir etkinlik eklediğinde Etkinlik eklemek için intent kullanma bölümünde açıklandığı gibi bir INSERT intent kullanmanızı öneririz. Ancak, doğrudan etkinlik ekleyebilirsiniz. Bu bölümde bunun nasıl yapılacağı açıklanmaktadır.

Yeni etkinlik eklemeye ilişkin kurallar şunlardır:

CALENDAR_ID ve DTSTART öğelerini eklemelisiniz.
EVENT_TIMEZONE eklemelisiniz. Sistemin yüklü saat dilimi kimliklerinin listesini almak için getAvailableIDs() değerini kullanın. Etkinlik eklemek için intent kullanma bölümünde açıklanan INSERT intent'i kullanarak etkinlik ekliyorsanız bu kuralın geçerli olmadığını unutmayın. Bu senaryoda varsayılan saat dilimi sağlanır.
Tekrarlanmayan etkinlikler için DTEND değerini eklemeniz gerekir.
Yinelenen etkinlikler için RRULE veya RDATE'ye ek olarak bir DURATION eklemeniz gerekir. Etkinlik eklemek için intent kullanma bölümünde açıklanan INSERT intent'i kullanarak etkinlik ekliyorsanız bu kuralın geçerli olmadığını unutmayın. Bu senaryoda, DTSTART ve DTEND ile birlikte bir RRULE kullanabilirsiniz. Takvim uygulaması, RRULE değerini otomatik olarak bir süreye dönüştürür.

Aşağıda, etkinlik eklemeyle ilgili bir örnek verilmiştir. Bu işlem, basitlik açısından kullanıcı arayüzü iş parçacığında gerçekleştirilir. Pratikte, ekleme ve güncellemeler eşzamansız iş parçacığı kullanarak işlemi arka plandaki bir ileti dizisine taşıyın. Daha fazla için bkz. AsyncQueryHandler.

Kotlin

val calID: Long = 3
val startMillis: Long = Calendar.getInstance().run {
    set(2012, 9, 14, 7, 30)
    timeInMillis
}
val endMillis: Long = Calendar.getInstance().run {
    set(2012, 9, 14, 8, 45)
    timeInMillis
}
...

val values = ContentValues().apply {
    put(CalendarContract.Events.DTSTART, startMillis)
    put(CalendarContract.Events.DTEND, endMillis)
    put(CalendarContract.Events.TITLE, "Jazzercise")
    put(CalendarContract.Events.DESCRIPTION, "Group workout")
    put(CalendarContract.Events.CALENDAR_ID, calID)
    put(CalendarContract.Events.EVENT_TIMEZONE, "America/Los_Angeles")
}
val uri: Uri = contentResolver.insert(CalendarContract.Events.CONTENT_URI, values)

// get the event ID that is the last element in the Uri
val eventID: Long = uri.lastPathSegment.toLong()
//
// ... do something with event ID
//
//

Java

long calID = 3;
long startMillis = 0;
long endMillis = 0;
Calendar beginTime = Calendar.getInstance();
beginTime.set(2012, 9, 14, 7, 30);
startMillis = beginTime.getTimeInMillis();
Calendar endTime = Calendar.getInstance();
endTime.set(2012, 9, 14, 8, 45);
endMillis = endTime.getTimeInMillis();
...

ContentResolver cr = getContentResolver();
ContentValues values = new ContentValues();
values.put(Events.DTSTART, startMillis);
values.put(Events.DTEND, endMillis);
values.put(Events.TITLE, "Jazzercise");
values.put(Events.DESCRIPTION, "Group workout");
values.put(Events.CALENDAR_ID, calID);
values.put(Events.EVENT_TIMEZONE, "America/Los_Angeles");
Uri uri = cr.insert(Events.CONTENT_URI, values);

// get the event ID that is the last element in the Uri
long eventID = Long.parseLong(uri.getLastPathSegment());
//
// ... do something with event ID
//
//

Not: Bu örnekte, etkinlik oluşturulduktan sonra etkinlik kimliğinin nasıl yakalandığına bakın. Bu, etkinlik kimliği almanın en kolay yoludur. Çoğu zaman diğer takvim işlemlerini gerçekleştirmek için (örneğin veya hatırlatıcılara ihtiyacınız olabilir.

Güncelleme etkinlikleri

Uygulamanız, kullanıcının bir etkinliği düzenlemesine izin vermek istediğinde EDIT Intent kullandığınızı Etkinliği düzenlemek için amaç kullanma bölümünde açıklanmıştır. Ancak gerekirse etkinlikleri doğrudan düzenleyebilirsiniz. Şunun bir güncellemesini gerçekleştirmek için: bir etkinlik için _ID özelliğini sağlayabilirsiniz etkinliği, Uri'ye eklenen bir kimlik olarak (withAppendedId()) veya ilk seçim öğesi olarak ekleyebilirsiniz. Seçim "_id=?" ile başlamalı ve ilk selectionArg, etkinliğin _ID olmalıdır. Kimliği olmayan bir seçim kullanarak da güncelleme yapabilirsiniz. Aşağıda, bir etkinliğin güncellenmesine ilişkin bir örnek verilmiştir. Etkinliğin başlığını withAppendedId(). yaklaşım:

Kotlin

val DEBUG_TAG = "MyActivity"
...
val eventID: Long = 188
...
val values = ContentValues().apply {
    // The new title for the event
    put(CalendarContract.Events.TITLE, "Kickboxing")
}
val updateUri: Uri = ContentUris.withAppendedId(CalendarContract.Events.CONTENT_URI, eventID)
val rows: Int = contentResolver.update(updateUri, values, null, null)
Log.i(DEBUG_TAG, "Rows updated: $rows")

Java

private static final String DEBUG_TAG = "MyActivity";
...
long eventID = 188;
...
ContentResolver cr = getContentResolver();
ContentValues values = new ContentValues();
Uri updateUri = null;
// The new title for the event
values.put(Events.TITLE, "Kickboxing");
updateUri = ContentUris.withAppendedId(Events.CONTENT_URI, eventID);
int rows = cr.update(updateUri, values, null, null);
Log.i(DEBUG_TAG, "Rows updated: " + rows);

Etkinlikleri sil

Bir etkinliği, URI'ya eklenen bir kimlik olarak _ID veya standart seçim. Eklenen kimlik kullanırsanız aynı zamanda seçim yapamazsınız. Silme işleminin iki sürümü vardır: uygulama olarak ve senkronizasyon bağdaştırıcısı olarak. uygulama silme işlemi, delete sütununu 1 olarak ayarlar. Bu işaret satırın silindiği ve bu silme işleminin gerektiği senkronizasyon bağdaştırıcısı sunucuya yayıldı. Senkronizasyon bağdaştırıcısı silme işlemi, etkinliği ilişkili tüm verileriyle birlikte veritabanından kaldırır. Aşağıda, _ID aracılığıyla bir etkinliği silen uygulama örneği verilmiştir:

Kotlin

val DEBUG_TAG = "MyActivity"
...
val eventID: Long = 201
...
val deleteUri: Uri = ContentUris.withAppendedId(CalendarContract.Events.CONTENT_URI, eventID)
val rows: Int = contentResolver.delete(deleteUri, null, null)
Log.i(DEBUG_TAG, "Rows deleted: $rows")

Java

private static final String DEBUG_TAG = "MyActivity";
...
long eventID = 201;
...
ContentResolver cr = getContentResolver();
Uri deleteUri = null;
deleteUri = ContentUris.withAppendedId(Events.CONTENT_URI, eventID);
int rows = cr.delete(deleteUri, null, null);
Log.i(DEBUG_TAG, "Rows deleted: " + rows);

Katılımcılar tablosu

CalendarContract.Attendees tablosundaki her satır bir etkinliğin tek bir katılımcısını veya davetlisini temsil eder. Telefon etme query(). şunun için katılımcı listesini döndürür: EVENT_ID ile etkinlik. Bu EVENT_ID belirli bir etkinliğin _ID ile eşleşmesi gerekir.

Aşağıdaki tabloda yazılabilir alanlar listelenmiştir. Yeni bir katılımcı eklerken tümünü dahil etmeniz gerekir ATTENDEE_NAME hariç.

Sabit	Açıklama
`EVENT_ID`	Etkinliğin kimliği.
`ATTENDEE_NAME`	Katılımcının adı.
`ATTENDEE_EMAIL`	Katılımcının e-posta adresi.
`ATTENDEE_RELATIONSHIP`	Katılımcının etkinlikle ilişkisi. Şunlardan biri: `RELATIONSHIP_ATTENDEE` `RELATIONSHIP_NONE` `RELATIONSHIP_ORGANIZER` `RELATIONSHIP_PERFORMER` `RELATIONSHIP_SPEAKER`
`ATTENDEE_TYPE`	Katılımcının türü. Şunlardan biri: `TYPE_REQUIRED` `TYPE_OPTIONAL`
`ATTENDEE_STATUS`	Katılımcının katılım durumu. Şunlardan biri: `ATTENDEE_STATUS_ACCEPTED` `ATTENDEE_STATUS_DECLINED` `ATTENDEE_STATUS_INVITED` `ATTENDEE_STATUS_NONE` `ATTENDEE_STATUS_TENTATIVE`

Katılımcı ekleme

Bir etkinliğe tek bir katılımcı eklemeyle ilgili bir örneği aşağıda bulabilirsiniz. EVENT_ID değerinin zorunlu olduğunu unutmayın:

Kotlin

val eventID: Long = 202
...
val values = ContentValues().apply {
    put(CalendarContract.Attendees.ATTENDEE_NAME, "Trevor")
    put(CalendarContract.Attendees.ATTENDEE_EMAIL, "trevor@example.com")
    put(
        CalendarContract.Attendees.ATTENDEE_RELATIONSHIP,
        CalendarContract.Attendees.RELATIONSHIP_ATTENDEE
    )
    put(CalendarContract.Attendees.ATTENDEE_TYPE, CalendarContract.Attendees.TYPE_OPTIONAL)
    put(
        CalendarContract.Attendees.ATTENDEE_STATUS,
        CalendarContract.Attendees.ATTENDEE_STATUS_INVITED
    )
    put(CalendarContract.Attendees.EVENT_ID, eventID)
}
val uri: Uri = contentResolver.insert(CalendarContract.Attendees.CONTENT_URI, values)

Java

long eventID = 202;
...
ContentResolver cr = getContentResolver();
ContentValues values = new ContentValues();
values.put(Attendees.ATTENDEE_NAME, "Trevor");
values.put(Attendees.ATTENDEE_EMAIL, "trevor@example.com");
values.put(Attendees.ATTENDEE_RELATIONSHIP, Attendees.RELATIONSHIP_ATTENDEE);
values.put(Attendees.ATTENDEE_TYPE, Attendees.TYPE_OPTIONAL);
values.put(Attendees.ATTENDEE_STATUS, Attendees.ATTENDEE_STATUS_INVITED);
values.put(Attendees.EVENT_ID, eventID);
Uri uri = cr.insert(Attendees.CONTENT_URI, values);

Hatırlatıcılar tablosu

CalendarContract.Reminders tablosunun her satırı, bir etkinlik için tek bir hatırlatıcıyı temsil eder. query() çağrısı, belirli bir EVENT_ID ile etkinlik için hatırlatıcıların listesini döndürür.

Aşağıdaki tabloda hatırlatıcılar için yazılabilir alanlar listelenmiştir. Yeni bir hatırlatıcı eklerken bunların tümü eklenmelidir. Senkronizasyon bağdaştırıcıların, destekledikleri hatırlatıcı türlerini CalendarContract.Calendars tablosunda belirttiğini unutmayın. Görüntüleyin ALLOWED_REMINDERS. inceleyebilirsiniz.

Sabit Açıklama

EVENT_ID Etkinliğin kimliği.

MINUTES Hatırlatıcının etkinleşmesi gereken etkinlikten dakika önce.

METHOD

Sunucuda ayarlandığı şekilde alarm yöntemi. Şunlardan biri:

Hatırlatıcı ekle

Bu örnek, bir etkinliğe hatırlatıcı ekler. Hatırlatıcı, etkinlikten 15 dakika önce etkinleştirilir.

Kotlin

val eventID: Long = 221
...
val values = ContentValues().apply {
    put(CalendarContract.Reminders.MINUTES, 15)
    put(CalendarContract.Reminders.EVENT_ID, eventID)
    put(CalendarContract.Reminders.METHOD, CalendarContract.Reminders.METHOD_ALERT)
}
val uri: Uri = contentResolver.insert(CalendarContract.Reminders.CONTENT_URI, values)

Java

long eventID = 221;
...
ContentResolver cr = getContentResolver();
ContentValues values = new ContentValues();
values.put(Reminders.MINUTES, 15);
values.put(Reminders.EVENT_ID, eventID);
values.put(Reminders.METHOD, Reminders.METHOD_ALERT);
Uri uri = cr.insert(Reminders.CONTENT_URI, values);

Örnekler tablosu

CalendarContract.Instances tablosu, bir etkinliğin gerçekleşmelerinin başlangıç ve bitiş zamanını içerir. Bu tablodaki her satır tek bir etkinlik oluşumunu temsil eder. Örnekler tablosu yazılabilir değildir ve yalnızca etkinlik oluşumlarını sorgulamanın bir yolunu sunar.

Aşağıdaki tabloda, bir örnek için sorgulayabileceğiniz bazı alanlar listelenmiştir. Not saat diliminin tanımlandığı yer KEY_TIMEZONE_TYPE. ve KEY_TIMEZONE_INSTANCES.

Sabit	Açıklama
`BEGIN`	UTC milisaniye cinsinden örneğin başlangıç zamanı.
`END`	UTC milisaniye cinsinden örneğin bitiş zamanı.
`END_DAY`	Takvim'in saat dilimine göre örneğin Jülyen bitiş günü.
`END_MINUTE`	Örneğin gece yarısından itibaren ölçülen örneğin bitiş dakikası Takvimin saat dilimi.
`EVENT_ID`	Bu örnek için etkinliğin `_ID` öğesi.
`START_DAY`	Takvim'in saat dilimine göre örneğin Jülyen başlangıç günü.
`START_MINUTE`	Gece yarısından itibaren ölçülen örneğin başlangıç dakikası, Takvimin saat dilimi.

Örnekler tablosunu sorgulama

Instances tablosunu sorgulamak için URI'de sorgu için bir zaman aralığı belirtmeniz gerekir. Bu örnekte, CalendarContract.Instances TITLE alanına, CalendarContract.EventsColumns arayüzünün uygulanması. Başka bir deyişle TITLE, veritabanı görünümü (ham CalendarContract.Instances tablosunun sorgulanmasıyla değil)

Kotlin

const val DEBUG_TAG: String = "MyActivity"
val INSTANCE_PROJECTION: Array<String> = arrayOf(
        CalendarContract.Instances.EVENT_ID, // 0
        CalendarContract.Instances.BEGIN, // 1
        CalendarContract.Instances.TITLE // 2
)

// The indices for the projection array above.
const val PROJECTION_ID_INDEX: Int = 0
const val PROJECTION_BEGIN_INDEX: Int = 1
const val PROJECTION_TITLE_INDEX: Int = 2

// Specify the date range you want to search for recurring
// event instances
val startMillis: Long = Calendar.getInstance().run {
    set(2011, 9, 23, 8, 0)
    timeInMillis
}
val endMillis: Long = Calendar.getInstance().run {
    set(2011, 10, 24, 8, 0)
    timeInMillis
}

// The ID of the recurring event whose instances you are searching
// for in the Instances table
val selection: String = "${CalendarContract.Instances.EVENT_ID} = ?"
val selectionArgs: Array<String> = arrayOf("207")

// Construct the query with the desired date range.
val builder: Uri.Builder = CalendarContract.Instances.CONTENT_URI.buildUpon()
ContentUris.appendId(builder, startMillis)
ContentUris.appendId(builder, endMillis)

// Submit the query
val cur: Cursor = contentResolver.query(
        builder.build(),
        INSTANCE_PROJECTION,
        selection,
        selectionArgs, null
)
while (cur.moveToNext()) {
    // Get the field values
    val eventID: Long = cur.getLong(PROJECTION_ID_INDEX)
    val beginVal: Long = cur.getLong(PROJECTION_BEGIN_INDEX)
    val title: String = cur.getString(PROJECTION_TITLE_INDEX)

    // Do something with the values.
    Log.i(DEBUG_TAG, "Event: $title")
    val calendar = Calendar.getInstance().apply {
        timeInMillis = beginVal
    }
    val formatter = SimpleDateFormat("MM/dd/yyyy")
    Log.i(DEBUG_TAG, "Date: ${formatter.format(calendar.time)}")
}

Java

private static final String DEBUG_TAG = "MyActivity";
public static final String[] INSTANCE_PROJECTION = new String[] {
    Instances.EVENT_ID,      // 0
    Instances.BEGIN,         // 1
    Instances.TITLE          // 2
  };

// The indices for the projection array above.
private static final int PROJECTION_ID_INDEX = 0;
private static final int PROJECTION_BEGIN_INDEX = 1;
private static final int PROJECTION_TITLE_INDEX = 2;
...

// Specify the date range you want to search for recurring
// event instances
Calendar beginTime = Calendar.getInstance();
beginTime.set(2011, 9, 23, 8, 0);
long startMillis = beginTime.getTimeInMillis();
Calendar endTime = Calendar.getInstance();
endTime.set(2011, 10, 24, 8, 0);
long endMillis = endTime.getTimeInMillis();

Cursor cur = null;
ContentResolver cr = getContentResolver();

// The ID of the recurring event whose instances you are searching
// for in the Instances table
String selection = Instances.EVENT_ID + " = ?";
String[] selectionArgs = new String[] {"207"};

// Construct the query with the desired date range.
Uri.Builder builder = Instances.CONTENT_URI.buildUpon();
ContentUris.appendId(builder, startMillis);
ContentUris.appendId(builder, endMillis);

// Submit the query
cur =  cr.query(builder.build(),
    INSTANCE_PROJECTION,
    selection,
    selectionArgs,
    null);

while (cur.moveToNext()) {
    String title = null;
    long eventID = 0;
    long beginVal = 0;

    // Get the field values
    eventID = cur.getLong(PROJECTION_ID_INDEX);
    beginVal = cur.getLong(PROJECTION_BEGIN_INDEX);
    title = cur.getString(PROJECTION_TITLE_INDEX);

    // Do something with the values.
    Log.i(DEBUG_TAG, "Event:  " + title);
    Calendar calendar = Calendar.getInstance();
    calendar.setTimeInMillis(beginVal);
    DateFormat formatter = new SimpleDateFormat("MM/dd/yyyy");
    Log.i(DEBUG_TAG, "Date: " + formatter.format(calendar.getTime()));
    }
 }

Takvim intent'leri

Uygulamanızın takvim verilerini okumak ve yazmak için izinlere ihtiyacı yoktur. Bunun yerine, okuma ve yazma işlemlerini Android'in Takvim uygulamasına aktarmak için Android'in Takvim uygulaması tarafından desteklenen intent'leri kullanabilir. Aşağıdaki tabloda, Takvim Sağlayıcı tarafından desteklenen intent'ler listelenmiştir:

İşlem	URI	Açıklama	Ekstralar
`VIEW`	`content://com.android.calendar/time/<ms_since_epoch>` Ayrıca, `CalendarContract.CONTENT_URI` Bu amacın kullanımına dair bir örnek için Takvim verilerini görüntülemek için intent'leri kullanma başlıklı makaleye bakın.	Takvimi `<ms_since_epoch>` tarafından belirtilen saatte aç.	Yok.
`VIEW`	`content://com.android.calendar/events/<event_id>` URI'ye `Events.CONTENT_URI` ile de referans verebilirsiniz. Bu intent'in kullanımıyla ilgili bir örnek için Takvim verilerini görüntülemek için intent'leri kullanma başlıklı makaleyi inceleyin.	`<event_id>` tarafından belirtilen etkinliği görüntüleyin.	`CalendarContract.EXTRA_EVENT_BEGIN_TIME` `CalendarContract.EXTRA_EVENT_END_TIME`
`EDIT`	`content://com.android.calendar/events/<event_id>` Ayrıca, `Events.CONTENT_URI` Bu niyetin kullanımına dair bir örnek için Etkinliği düzenlemek için niyet kullanma başlıklı makaleyi inceleyin.	`<event_id>` tarafından belirtilen etkinliği düzenleyin.	`CalendarContract.EXTRA_EVENT_BEGIN_TIME` `CalendarContract.EXTRA_EVENT_END_TIME`
`EDIT` `INSERT`	`content://com.android.calendar/events` URI'ye `Events.CONTENT_URI` ile de referans verebilirsiniz. Bu niyetin kullanımına dair bir örnek için Etkinlik eklemek için niyet kullanma başlıklı makaleyi inceleyin.	Bir etkinlik oluşturun.	Aşağıdaki tabloda listelenen ekstralardan herhangi biri.

Aşağıdaki tabloda Takvim Sağlayıcısı tarafından desteklenen intent ekstraları listelenmiştir:

Intent Ekstra	Açıklama
`Events.TITLE`	Etkinliğin adı.
`CalendarContract.EXTRA_EVENT_BEGIN_TIME`	Dönemden bu yana geçen, milisaniye cinsinden etkinlik başlangıç zamanı.
`CalendarContract.EXTRA_EVENT_END_TIME`	Dönemden itibaren milisaniye cinsinden etkinlik bitiş zamanı.
`CalendarContract.EXTRA_EVENT_ALL_DAY`	Bir etkinliğin tüm gün olduğunu belirten bir boole değeri. Değer `true` veya `false` olabilir.
`Events.EVENT_LOCATION`	Etkinliğin konumu.
`Events.DESCRIPTION`	Etkinlik açıklaması.
`Intent.EXTRA_EMAIL`	Virgülle ayrılmış liste olarak davet edilecek kişilerin e-posta adresleri.
`Events.RRULE`	Etkinliğin yinelenme kuralı.
`Events.ACCESS_LEVEL`	Etkinliğin gizli mi yoksa herkese açık mı olduğu.
`Events.AVAILABILITY`	Bu etkinlik meşgulse veya planlanabilecek boş zaman olarak mı sayılıyor?

Aşağıdaki bölümlerde bu amaçların nasıl kullanılacağı açıklanmaktadır.

Etkinlik eklemek için intent kullanma

INSERT Amacını Kullanma uygulamanızın etkinlik ekleme görevini Takvim'e aktarmasını sağlar. Bu yaklaşımda uygulamanızın manifest dosyasına WRITE_CALENDAR izninin eklenmesine bile gerek yoktur.

Kullanıcılar bu yaklaşımı kullanan bir uygulamayı çalıştırdığında uygulama, etkinliği eklemeyi tamamlamaları için onları Takvim'e gönderir. INSERT Intent, aşağıdaki amaçlarla ek alanları kullanır: etkinliğin ayrıntılarıyla bir formu önceden doldurabilirsiniz. Kullanıcılar şunları yapabilir: ardından etkinliği iptal edebilir, formu gerektiği şekilde düzenleyebilir veya etkinliği takvim.

Aşağıda, 19 Ocak 2012'de saat 07:30 ile 08:30 arasında gerçekleşecek bir etkinlik planlayan bir kod snippet'i verilmiştir. Bu kod snippet'iyle ilgili aşağıdaki noktalara dikkat edin:

Events.CONTENT_URI değerini belirtiyor kullanır.
Formu etkinliğin saatiyle önceden doldurmak için CalendarContract.EXTRA_EVENT_BEGIN_TIME ve CalendarContract.EXTRA_EVENT_END_TIME ek alanlarını kullanır. Bu zamanların değerleri, başlangıç tarihinden itibaren UTC milisaniye cinsinden olmalıdır.
Intent.EXTRA_EMAIL kullanır ekstra alana girin.

Kotlin

val startMillis: Long = Calendar.getInstance().run {
    set(2012, 0, 19, 7, 30)
    timeInMillis
}
val endMillis: Long = Calendar.getInstance().run {
    set(2012, 0, 19, 8, 30)
    timeInMillis
}
val intent = Intent(Intent.ACTION_INSERT)
        .setData(CalendarContract.Events.CONTENT_URI)
        .putExtra(CalendarContract.EXTRA_EVENT_BEGIN_TIME, startMillis)
        .putExtra(CalendarContract.EXTRA_EVENT_END_TIME, endMillis)
        .putExtra(CalendarContract.Events.TITLE, "Yoga")
        .putExtra(CalendarContract.Events.DESCRIPTION, "Group class")
        .putExtra(CalendarContract.Events.EVENT_LOCATION, "The gym")
        .putExtra(CalendarContract.Events.AVAILABILITY, CalendarContract.Events.AVAILABILITY_BUSY)
        .putExtra(Intent.EXTRA_EMAIL, "rowan@example.com,trevor@example.com")
startActivity(intent)

Java

Calendar beginTime = Calendar.getInstance();
beginTime.set(2012, 0, 19, 7, 30);
Calendar endTime = Calendar.getInstance();
endTime.set(2012, 0, 19, 8, 30);
Intent intent = new Intent(Intent.ACTION_INSERT)
        .setData(Events.CONTENT_URI)
        .putExtra(CalendarContract.EXTRA_EVENT_BEGIN_TIME, beginTime.getTimeInMillis())
        .putExtra(CalendarContract.EXTRA_EVENT_END_TIME, endTime.getTimeInMillis())
        .putExtra(Events.TITLE, "Yoga")
        .putExtra(Events.DESCRIPTION, "Group class")
        .putExtra(Events.EVENT_LOCATION, "The gym")
        .putExtra(Events.AVAILABILITY, Events.AVAILABILITY_BUSY)
        .putExtra(Intent.EXTRA_EMAIL, "rowan@example.com,trevor@example.com");
startActivity(intent);

Bir etkinliği düzenlemek için intent kullanma

Bir etkinliği doğrudan güncelleyebilirsiniz. Bunun için Etkinlikleri güncelleme bölümünde açıklanan adımları uygulayın. Ancak EDIT amacı, etkinlik düzenlemeyi Takvim uygulamasına devretme izni olmayan bir uygulamanın bunu yapmasına olanak tanır. Kullanıcılar Takvim'de etkinliklerini düzenlemeyi bitirdiğinde orijinal uygulamaya geri yönlendirilir.

Belirtilen bir etkinlik için yeni bir başlık ayarlayan ve kullanıcıların etkinliği Takvim'de düzenlemesine olanak tanıyan bir intent örneği aşağıda verilmiştir.

Kotlin

val eventID: Long = 208
val uri: Uri = ContentUris.withAppendedId(CalendarContract.Events.CONTENT_URI, eventID)
val intent = Intent(Intent.ACTION_EDIT)
        .setData(uri)
        .putExtra(CalendarContract.Events.TITLE, "My New Title")
startActivity(intent)

Java

long eventID = 208;
Uri uri = ContentUris.withAppendedId(Events.CONTENT_URI, eventID);
Intent intent = new Intent(Intent.ACTION_EDIT)
    .setData(uri)
    .putExtra(Events.TITLE, "My New Title");
startActivity(intent);

Takvim verilerini görüntülemek için amaçları kullanma

Takvim Sağlayıcı, VIEW intent'ini kullanmanın iki farklı yolunu sunar:

Takvim'i belirli bir tarihte açmak için.
Bir etkinliği görüntülemek için.

Takvim'in belirli bir tarihte nasıl açılacağını gösteren bir örnek aşağıda verilmiştir:

Kotlin

val startMillis: Long
...
val builder: Uri.Builder = CalendarContract.CONTENT_URI.buildUpon()
        .appendPath("time")
ContentUris.appendId(builder, startMillis)
val intent = Intent(Intent.ACTION_VIEW)
        .setData(builder.build())
startActivity(intent)

Java

// A date-time specified in milliseconds since the epoch.
long startMillis;
...
Uri.Builder builder = CalendarContract.CONTENT_URI.buildUpon();
builder.appendPath("time");
ContentUris.appendId(builder, startMillis);
Intent intent = new Intent(Intent.ACTION_VIEW)
    .setData(builder.build());
startActivity(intent);

Bir etkinliğin görüntüleme için nasıl açılacağını gösteren örnek:

Kotlin

val eventID: Long = 208
...
val uri: Uri = ContentUris.withAppendedId(CalendarContract.Events.CONTENT_URI, eventID)
val intent = Intent(Intent.ACTION_VIEW).setData(uri)
startActivity(intent)

Java

long eventID = 208;
...
Uri uri = ContentUris.withAppendedId(Events.CONTENT_URI, eventID);
Intent intent = new Intent(Intent.ACTION_VIEW)
   .setData(uri);
startActivity(intent);

Senkronizasyon bağdaştırıcıları

Uygulama ile senkronizasyon bağdaştırıcısı arasında çok küçük farklar vardır. Takvim Sağlayıcısına erişin:

Bir senkronizasyon bağdaştırıcısı, CALLER_IS_SYNCADAPTER öğesini true olarak ayarlayarak bunun bir senkronizasyon bağdaştırıcısı olduğunu belirtmesi gerekir.
Senkronizasyon bağdaştırıcının, URI'de sorgu parametresi olarak bir ACCOUNT_NAME ve bir ACCOUNT_TYPE sağlaması gerekir.
Senkronizasyon bağdaştırıcısı, bir uygulama veya widget'tan daha fazla sütuna yazma erişimine sahiptir. Örneğin, bir uygulama bir takvimin yalnızca birkaç özelliğini değiştirebilir. Örneğin, adı, görünen adı, görünürlük ayarı ve takvimin senkronize edildi. Buna karşılık, bir senkronizasyon bağdaştırıcısı yalnızca bu sütunlara değil, diğer birçok sütuna erişebilir ve Örneğin, takvim rengi, saat dilimi, erişim düzeyi, konum vs. Ancak senkronizasyon bağdaştırıcısı, belirttiği ACCOUNT_NAME ve ACCOUNT_TYPE ile sınırlıdır.

Senkronizasyon bağdaştırıcısıyla kullanılmak üzere URI döndürmek için kullanabileceğiniz yardımcı bir yöntemi burada bulabilirsiniz:

Kotlin

fun asSyncAdapter(uri: Uri, account: String, accountType: String): Uri {
    return uri.buildUpon()
            .appendQueryParameter(CalendarContract.CALLER_IS_SYNCADAPTER, "true")
            .appendQueryParameter(CalendarContract.Calendars.ACCOUNT_NAME, account)
            .appendQueryParameter(CalendarContract.Calendars.ACCOUNT_TYPE, accountType).build()
}

Java

static Uri asSyncAdapter(Uri uri, String account, String accountType) {
    return uri.buildUpon()
        .appendQueryParameter(android.provider.CalendarContract.CALLER_IS_SYNCADAPTER,"true")
        .appendQueryParameter(Calendars.ACCOUNT_NAME, account)
        .appendQueryParameter(Calendars.ACCOUNT_TYPE, accountType).build();
 }