連絡先

contactsオブジェクトは、デバイスの連絡先データベースへのアクセスを提供します。

重要なプライバシーの注意：連絡先データの収集と利用を重要なプライバシーの問題を発生させます。 アプリのプライバシー ポリシー アプリが連絡先データを使用する方法と、他の当事者では共有されているかどうかを話し合う必要があります。 人誰と通信する人々 を明らかにするために、連絡先情報が機密と見なされます。 したがって、アプリのプライバシー ポリシーに加えて、強くする必要がありますアプリへのアクセスまたはを使用して連絡先データをデバイス オペレーティング システムしないので既に) の前に - 時間の通知を行うこと。 その通知は、上記の (例えば、 [ok]をおかげで選択肢を提示する) によってユーザーのアクセス許可を取得するだけでなく、同じ情報を提供する必要があります。 いくつかのアプリのマーケットプ レース - 時間の通知を提供して、連絡先データにアクセスする前のユーザーのアクセス許可を取得するアプリをする必要がありますに注意してください。 データはユーザーの混乱を避けるために役立つ連絡先の使用および連絡先データの知覚の誤用を囲む明確でわかりやすいユーザー エクスペリエンス。 詳細については、プライバシーに関するガイドを参照してください。

メソッド

• contacts.create
• contacts.find

引数

• 連絡先
• contactSuccess
• contactError
• contactFindOptions

オブジェクト

• お問い合わせ
• 得意先コード
• ContactField
• ContactAddress
• ContactOrganization
• ContactFindOptions
• ContactError

機能へのアクセス

バージョン 3.0 は、コルドバのプラグインとしてデバイス レベルの Api を実装します。 CLI の使用 plugin のコマンドライン ・ インタ フェースを追加または削除、プロジェクトに対してこの機能を記載されているコマンド。

    $ cordova plugin add org.apache.cordova.contacts
    $ cordova plugin ls
    [ 'org.apache.cordova.contacts' ]
    $ cordova plugin rm org.apache.cordova.contacts

これらのコマンドすべてのターゲット プラットフォームに適用されますが、以下のプラットフォームに固有の構成設定を変更します。

• アンドロイド

  (in app/res/xml/config.xml)
  <feature name="Contacts">
      <param name="android-package" value="org.apache.cordova.ContactManager" />
  </feature>
  
  (in app/AndroidManifest.xml)
  <uses-permission android:name="android.permission.GET_ACCOUNTS" />
  <uses-permission android:name="android.permission.READ_CONTACTS" />
  <uses-permission android:name="android.permission.WRITE_CONTACTS" />
  

• ブラックベリー WebWorks

  (in www/plugins.xml)
  <feature name="Contact">
      <param name="blackberry-package" value="org.apache.cordova.pim.Contact" />
  </feature>
  
  (in www/config.xml)
  <feature id="blackberry.find"        required="true" version="1.0.0.0" />
  <feature id="blackberry.identity"    required="true" version="1.0.0.0" />
  <feature id="blackberry.pim.Address" required="true" version="1.0.0.0" />
  <feature id="blackberry.pim.Contact" required="true" version="1.0.0.0" />
  

• iOS （config.xml)

  <feature name="Contacts">
      <param name="ios-package" value="CDVContacts" />
  </feature>
  

• Windows Phone

  (in Properties/WPAppManifest.xml)
  <Capabilities>
      <Capability Name="ID_CAP_CONTACTS" />
  </Capabilities>
  

  参照: Windows Phone のアプリケーション マニフェスト

いくつかのプラットフォームは特別な構成を必要とせずにこの機能をサポート可能性があります。プラットフォームのサポートの概要のセクションを参照してください。