Making Your Apps More Sociable

Making your apps more sociable

Contents

Map & Locations features– Map control– Location provider– Remote landmark store

Social features– Buddy– SNS gateway

*This material is based on bada SDK 1.0.0b3

Map in bada

Think of this …

To do this, you need to …

Display a map– Map control

Get my current location– Location provider

Store information which has a location– Database– Landmark store (Device & Remote )

Location application essentials

You must set the privilege group:

Features Header Library Priv. group Priv. level

Map Control

FLocations.h

FlocationControls LOCATION_SERVICE NORMAL

Location ProviderFLocations

LOCATION NORMALRemote Landmark Store REMOTE_LANDMARK SYSTEM

Map in bada1. Map control

2. Location provider

3. Remote landmark store

Getting a deCarta keyGO!http://developer.decarta.com

Using the map control (1/4)

Step 1: Set the map key for deCarta:String extraInfo = L"ClientName=( );ClientPassword=( );HostUrl=http://ws.decarta.com/openls/openls";

Step 1: Set the map key for deCarta:

Step 2: Create a map provider:

String extraInfo = L"ClientName=( );ClientPassword=( );HostUrl=http://ws.decarta.com/openls/openls";

IMapServiceProvider* __pMapProvider;

__pMapProvider = static_cast<IMapServiceProvider*>(ProviderManager::ConnectToServiceProviderN(L"deCarta",LOC_SVC_PROVIDER_TYPE_MAP, extraInfo));

Step 1: Set the map key for deCarta

Step 2: Create a map provider

Step 3: Construct the map control:__pMap = new Map();__pMap->Construct(Rectangle(/*size*/), *__pMapProvider);

Step 1: Set the map key for deCarta

Step 2: Create a map provider

Step 3: Construct the map control:

Step 4: Set the map control :

__pMap = new Map();__pMap->Construct(Rectangle(/*size*/), *__pMapProvider);

__pMap->SetCenter(/* latitude, longitude */, false);__pMap->SetPanEnabled(true);

When maps are not displayed

Check that the name and password are valid

Check the proxy if you are

in a proxy environment

Setting proxies

Run the simulator:

Menu > Settings > Connectivity > Network > Connection > bada

Location in bada1. Map control

3. Remote Landmark Store

Getting the position from the GPS

Step 1: Add a location update listener:__pLocProvider = new LocationProvider();__pLocProvider->Construct(LOC_METHOD_GPS);__pLocProvider->RequestLocationUpdates

(/*ILocationListener &*/, 5, false);

Getting the position from the GPS

Step 1: Add a location update listener:

Step 2: Get the position in the listener:

__pLocProvider = new LocationProvider();__pLocProvider->Construct(LOC_METHOD_GPS);__pLocProvider->RequestLocationUpdates

(/*ILocationListener &*/, 5, false);

void MyClass::OnLocationUpdated(Location &loc){

const QualifiedCoordinates* pCoord = loc.GetQualifiedCoordinates();

if (null != pCoord)__pMap->SetCenter(*pCoord, true);

Location in bada1. Map control

3. Remote landmark store

Landmarks

A landmark is a location that has a name

In bada, Landmark consists of:Data structures

Description

Coordinates

Landmark stores

A landmark store is a persistent database for landmarks

Landmarks can be stored on the device or on the bada Server

Remote landmark stores can be shared among bada users

Accessing bada Server

You need a bada account to store landmarks on bada Server

Samsung bada provides an easier way for sign up and sign in:– AppControl

AppControl

AppControl is used to start an application and control specific behavior in it

APPCONTROL_CALENDAR APPCONTROL_DIAL APPCONTROL_MEDIA

Signing in the bada Server

AppControl* pAc = AppManager::FindAppControlN(APPCONTROL_SIGNIN, OPERATION_SIGNIN);

if(null != pAc) {pAc->Start(null, this);delete pAc;

Adding landmarks to a LandmarkStore

Step 1: Create a landmark:Landmark* pLandmark = new Landmark();pLandmark->SetQualifiedCoordinates(/* QualfiedCoor */);pLandmark->SetName(/*name*/);pLandmark->SetDescription(/*description*/);

Adding landmarks to a LandmarkStore

Step 1: Create a landmark:

Step 2: Add a landmark to a RemoteLandmarkStore:

Landmark* pLandmark = new Landmark();pLandmark->SetQualifiedCoordinates(/* QualfiedCoor */);pLandmark->SetName(/*name*/);pLandmark->SetDescription(/*description*/);

__pServerStore = new RemoteLandmarkStore(/*STORE NAME*/, /*IRemoteLandmarkStoreListener&*/);

__pServerStore->AddLandmark(*pLandmark, /*category*/, reqId);

Searching for landmarks (1/2)

Step 1: Request a search:void MyApp::OnMapDrawCompleted(const Map& source){

RectangleGeographicArea area= source.GetViewport();LandmarkFilter filter;filter.SetGeographicAreaFilter(&area);

LandmarkPropertySelector selector;selector.SetQualifiedCoordinatesSelector(true);selector.SetDescriptionSelector(true);

RequestId reqId;__pServerStore->SearchLandmarks

(&filter, &selector, null, SORT_ORDER_ASCENDING, SORT_BY_NAME, reqId);

Step 1: Request a search

Step 2: Get results:void MyApp::OnLandmarksReceivedN(…, IList* pResults, …){

// implement this handler}

Landmark Manager Demo:

Demo sequence:– Display a map– Search the nearby landmark– Display the landmark information

More features for locationsModule Major Uses

Remote locationprovider

Send a location to bada ServerGet other people’s (last known) position

Trace service Get other people’s trajectories

Map service Get a map

Directory service Search through landmarks from a service provider

Geocoding service Perform geocoding and reverse-geocoding

Route service Get a routing information from starting point to end point

When Location meets social features …

Using buddy features

Request, respond to, and delete buddies

Manage groups and friendship levels within your buddies

Share your location, contents, or profile with buddies

Social in bada1. Searching profile

2. Becoming buddies

3. Sharing locations

Searching profile

bada Server

1. Set profile exposure level2. Search Mike’s profile

3.Send buddy request

4. Respond tobuddy request

Mike: Set profile exposure level

Step 1: Create a PrivacyManager:__privacyManager = new PrivacyManager();__privacyManager->Construct

(IPrivacyManagerListener&);

I want to share my location

Step 1: Create a PrivacyManager:

Step 2: Set the ProfileExposureLevel:

__privacyManager = new PrivacyManager();__privacyManager->Construct

__privacyManager->SetProfileExposureLevel(PROFILE_SEARCHABLE, reqId);

Set my profile searchable

Step 1: Create a PrivacyManager:

Step 2: Set the ProfileExposureLevel:

Step 3: Confirm the result:

__privacyManager = new PrivacyManager();__privacyManager->Construct

__privacyManager->SetProfileExposureLevel(PROFILE_SEARCHABLE, reqId);

Is the set request

successful?

void OnProfileExposureLevelUpdated(){…}

You must sign-in with bada account before using PrivacyManager!38

Jane: Search profile

Step 1: Construct a ProfileService:__pProfileService = new ProfileService();__pProfileService->Construct

(IProfileServiceListener&);

I want to find some friends

on bada

Step 1: Construct a ProfileService:

Step 2: Search profiles:

– Search by Email, LoginId, Name, PhoneNumber

__pProfileService = new ProfileService();__pProfileService->Construct

__pProfileService->SearchProfilesByName(L”Mike”, …);

Let me try Mike

Step 1: Construct a ProfileService:

Step 2: Search profiles:

– Search by Email, LoginId, Name, PhoneNumber

Step 3: Receive profiles:

__pProfileService = new ProfileService();__pProfileService->Construct

__pProfileService->SearchProfilesByName(L”Mike”, …);

void OnProfileSearchResultsReceivedN(…, Osp::Base::Collection::IList* pBasicProfileList,…)

Can I check the results?

Social1. Searching profile

2. Becoming buddies

Becoming buddies

bada Server

1. Set profile exposure level2. Search Mike’s profile

3. Send abuddy request 4. Respond to buddy request

Jane: Send a buddy request

Step 1: Create a BuddyService:__pBuddyService = new BuddyService();__pBuddyService->Construct

(IBuddyServiceListener &);

How can I send the

request to Mike

Step 1: Create a BuddyService:

Step 2: Send a buddy request:

__pBuddyService = new BuddyService();__pBuddyService->Construct

__pBuddyService->RequestBuddy(/* Mikes’s UserID */, reqId);

Send the request

Step 1: Create a BuddyService:

Step 2: Send a buddy request:

Step 3: Confirm results:

__pBuddyService = new BuddyService();__pBuddyService->Construct

__pBuddyService->RequestBuddy(/* Mikes’s UserID */, reqId);

And I can confirm the

results

void OnBuddyRequestSent(…){…}

Mike: Respond to a buddy request

Step 1: Get buddy requests: __pBuddyService->GetReceivedBuddyRequests(reqId);

Is there any buddy

request I received?

Step 1: Get buddy requests:

Step 2: Receive buddy requests:

__pBuddyService->GetReceivedBuddyRequests(reqId);

void OnReceivedBuddyRequestsReceivedN(…,IList*pRequestList ,…)

Get the request from the server

Step 1: Get buddy requests:

Step 2: Receive buddy requests:

Step 3: Respond to buddy requests:

__pBuddyService->GetReceivedBuddyRequests(reqId);

void OnReceivedBuddyRequestsReceivedN(…,IList*pRequestList ,…)

__pBuddyService->RespondToBuddyRequest(*pRequest, RESPONSE_ACCEPT , reqId);

Got Jane’s, Ok accept!

Social 1. Searching profile

2. Becoming buddies

Sharing locations

bada Server

1. Share Mike’s location

2. Search Mike’s location

Mike: Share a location

Step 1: Set access control list for location:__privacyManager->SetUserInfoPrivacy

(INFO_LOCATION , ACCESS_BUDDY , reqId);

Can I share my location

to my friends?

Step 1: Set access control list for location:

Step 2: Get Mike’s location:

__privacyManager->SetUserInfoPrivacy(INFO_LOCATION , ACCESS_BUDDY , reqId);

__pLocationProvider->RequestLocationUpdates(…);

Get my current location

Step 1: Set access control list for location:

Step 2: Get Mike’s location:

Step 3: Register Mike’s location to bada Server:

__privacyManager->SetUserInfoPrivacy(INFO_LOCATION , ACCESS_BUDDY , reqId);

__pLocationProvider->RequestLocationUpdates(…);

RemoteLocationProvider::StartLocationReport(…);

Send my location to the server

MyPlace Demo:

Demo sequence:– Display a map– Get my friends location– Display them on the map

The SNS Gateway

SNS gateway

The SNS gateway has unified APIs for different SNS providers

Check the SNS provider’s features and properties before using the SNS gateway:

* MySpace will be supported in SDK b2

Property Description Twitter Facebook

First Name The person’s given name.

Last Name The person’s family name.

Display Name The person’s display name.

User Name The person’s user name.

SNS gateway

badaServer

1. Sharing my position

3. Set my status4. Get friend status

2. Show my and Jane’s locations

Mike Jane

SNS Server Alice

Authentication

Step 1: Create SNS gateway __pSnsGateway = new SnsGateway();__pSnsGateway->Construct

(ISnsGatewayListener&, ISnsContentListener *,ISnsPeopleListener *, ISnsActivityListener *);

Authentication

Step 1: Create SNS gateway

Step 2: Login to SNS account using SNS gateway API

__pSnsGateway = new SnsGateway();__pSnsGateway->Construct

(ISnsGatewayListener&, ISnsContentListener *, ISnsPeopleListener *, ISnsActivityListener *);

__pAuthenticator = new SnsAuthenticator();__pAuthenticator->Construct(ISnsAuthenticatorListener & );__pAuthenticator->Authenticate

(L"twitter", /*Key*/, /*Secret*/);…__pSnsGateway->AddAuthResult(authResult);

Updating and getting status

Update user status:__pSnsGateway->UpdateMyStatusText

(L”twitter”, L”Let’s meet at Starbucks”, reqId);

Updating and getting status

Update user status:

Get friend’s status :

__pSnsGateway->UpdateMyStatusText(L”twitter”, L”Let’s meet at Starbucks”, reqId);

__pSnsGateway->GetStatusText(L"twitter", L”Mike”, reqId);

…void OnSnsStatusTextReceived

(..., SnsStatusText *pStatusText, ...)

SimpleTwitter Demo:

Demo sequence:– Sing-in with the bada account– Authenticate with the Twitter server– Update tweets

Manage personal data on the device and server

Share and interact with other users

More social features

Device Features

Server-assisted Features

•AddressBook

•CalendarBook

•Lifelog

•Buddy •Profile •Board

•Messaging •SNS Gateway

Social application essentials

Features Header Library Priv. Group Priv. LevelPrivacyManager

FSocial.h FSocialServices

PRIVACY_SERVICE SYSTEMProfileService PROFILE_SERVICE SYSTEMBuddyService BUDDY_SERVICE SYSTEMSnsGateway SNS_SERVICE SYSTEM

Summary

What we have learned

Locations:– How to use the Map control– How to get a location– How to use a remote landmark store– How to get other people’s locations

Social:– How to get buddy– How to use the SNS Gateway

Find out more: Locations

Tutorial:– bada Tutorial.Location.pdf

Samples:– LandmarkManager– LocationManager– MapControl– MapViewer– Navigator

Find out more: Social

Tutorial:– bada Tutorial.Social.pdf

Samples:– BuddyManager– PrivacyManager– SimpleTwitter– TwitterOAuth

Making Your Apps More Sociable

Documents

App Music_Android Music Making Apps 2013

Making awesome apps

Making Thinking Visible Using iPad Apps

Beyond VoiceOver: making iOS apps accessible

Making Cross-Platform apps with Xamarin

Beyond Apps: Making Teaching & Learning Mobile

SOCIABLE Septiembre 2012

Money Making Apps for iPhone

Coast Spas Getting Sociable!

Towards Sociable Robots

Sociable Robotics

SOCIABLE - NEXT GENERATION COGNITIVE TRAINING USING … · SOCIABLE clinical study yThe SOCIABLE pilot study was a ymulti-national ÆGreece, Italy, Norway and Spain ymulticenter Æ7

SOCIABLE Agosto 2012

Sociable 2

Making your Apps International

Making our web apps safely hackable

The Making of Tesla Smartwatch Apps

eBook Se Sociable

Sociable Media

Viral Loops: Making Self-Marketing Apps